web开发相关命名规范——大小写(基于Vue的前端开发)
背景
web开发相比于传统桌面应用,涉及到更多系统,包括前端页面(HTML、CSS)、脚本(Javascript)、前端框架、网络(url)、服务器(网络路径和文件资源)等,且不同系统支持的命名规范和习惯不尽相同,可能会导致开发的混乱。在本篇中统一整理一份目录,方便后续查询和使用。
命名规范介绍
目前流行的命名规范主要是以下几类:
- 驼峰命名法:单词间无特殊符号,单词首字母大写,其他字母小写;可以继续细分为:
- 大驼峰(也叫 Pascal 命名法):第一个单词首字母也大写,如:PascalCase
- 小驼峰:第一个单词首字母小写,如:camelCase
 
- 大驼峰(也叫 Pascal 命名法):第一个单词首字母也大写,如:
- 蛇形命名法(下划线命名法):单词间使用下划线连接,可以根据需要使用全小写或全大写,混用的不多见,如:first_one
- 减号命名法:单词间使用减号连接,通常使用全小写,如:kebab-case
web项目各场景推荐命名法
前端页面:
- html:html 对大小写不敏感,因此推荐始终使用小写,包括属性名、事件名,但为了易读,建议使用 kebab-case;此外,事件的回调函数使用camelCase,因为这属于 JS 的范畴
- css:同 html,建议使用 kebab-case,更进一步基于 BEM 规范,使用 “模块-元素--修饰符”的形式,如:block-element--modifier,适合开发组件库时使用
- Javascript:使用与其他编程语言类似的命名约定
- 构造函数/类使用 PascalCase
- 常量使用全大写的蛇形命名,如:MATH_PI,
- 其他变量使用 camelCase
 
- 构造函数/类使用 
- Vue 组件相关:常用 PascalCase和kebab-case。其中,PascalCase比起kebab-case在某些方面有额外优势,如方便代码自动补全、易识别(指与其他元素或组件作区分,如 html 元素或 web component 组件)- 实例内注册组件或单文件组件,推荐 kebab-case或PascalCase。其中,单文件 Vue 组件或在 JSX 中的组件,使用 ;而通过 Vue.component 注册的组件建议使用kebab-case更多 Vue 组件的命名风格建议翻阅官方文档 : https://cn.vuejs.org/v2/style-guide/#优先级-B-的规则:强烈推荐-增强可读性 
- prop 与自定义事件:建议定义时使用 camelCase,然后在模板上使用kebab-case;同样地,(包括自定义)事件的回调函数使用camelCase
 
- 实例内注册组件或单文件组件,推荐 
- 网络相关(这部分暂时了解不多,等待后续完善)
- url(网站地址部分):建议使用全小写的蛇形命名法,如:site_logo
- 资源路径和资源文件名:根据服务器架设所用的系统会有不同,windows 环境下大小写不敏感,而 Unix/Linux环境下区分大小写
 
解决 VSCODE 不能双击选中 kebab-case 形式的标识符
鉴于前端开发需要大量使用 kebab-case 命名法,优化开发环境就显得尤为重要。默认配置下,VSCODE 不支持双击选中此类标识符,因此需要以下的调整:
1、打开设置【文件-首选项-设置】,搜索 editor.wordSeparators(此处的配置会将指定的字符全部作为单词的分隔符,因此导致无法双击选中)
2、复制下面一段内容替换掉 wordSeparators 里面的内容(也就是删除原字符串中的减号),使编辑器将减号视作标识符单词的一部分,而不是作为分隔符
原字符串:
`~!@#$%^&*()-=+[{]}|;:'",.<>/?
替换成:
`~!@#$%^&*()=+[{]}|;:'",.<>/?
 
                    
                     
                    
                 
                    
                
 
                
            
         
         浙公网安备 33010602011771号
浙公网安备 33010602011771号