详解一些适用于Node.js的命名约定


Posted in Javascript onDecember 08, 2019

序言

There are only two hard things in Computer Science: cache invalidation and naming things.
-- Phil Karlton

我乔鲁诺·乔巴拿有一个梦想,便是要成为程序员巨星。但如果你看过我写的代码,便知道我还远远够不上“巨星”二字。我的代码中有许多不一致的命名:

  1. 常量的命名时而是全大写的(如WAIT_CONFIRM),时而是全小写的;
  2. 某个项目大部分命名用的是camel case(如TaskController),但由于数据库中的列名用了snake case(如context_id),导致项目中与数据库列有关的代码混用了camel case和snake case(如restricted_hours[new Date(timestamp * 1000).getHours()] = 1;);
  3. 同样是构造复杂对象的函数,它们的前缀可能会是build、create、make,甚至compute中的任何一个;
  4. 明明是一个数组,却用了单数的order作为变量名。

之所以如此混乱,正是因为我没有遵循一套一致的命名规则。每当我在一个项目中蹦出一些新想法时,便会跃跃欲试——不,我真的就用上了。我不曾整理过自己的命名规则(天哪我已经写了三年的JavaScript了),以至于无从判断“新想法”是否真的新——也许它是一个已经被我抛弃的规则。

为了不再深陷不一致命名的泥潭,我定下了本篇的命名规则,期望它们为以后的我指点迷津。

变量名

通用规则

  • 变量名使用camel case的命名风格。例如,使用namingConvention,而不是naming_convention;
  • 在尽量遵循规则的基础上随机应变。

变量名的单复数规则

  • 如果一个变量存储的值的类型为数组(即该变量作为Array.isArray方法的参数时结果为真),那么变量的名称就使用复数形式。例如,使用fruits = []而不是fruit = []。
  • 如果一个变量存储的值的类型为集合(即Set这个类型),那么变量的名称应当使用单词unique为前缀。例如,使用uniqueUserIds而不是userIdSet。

布尔变量的命名规则

如果一个变量的值的类型为boolean,那么变量的名称应当以下列单词为前缀:

  • is。当变量表达一个二元状态的时候,例如isFull、isEmpty。在is后面的应当是一个形容词;
  • has。当变量表达历史上是否发生过某个事件的时候,例如hasPaid、hasArrived。在has后面的应当是一个动词,并且采用过去分词;
  • can。当变量表达某种权限的时候,例如canWrite、canExecute。在can后面的应当是一个动词,并且采用现在分词。

数值变量的命名规则

  • 如果变量中存储的是一系列数字中的最大值,那么变量的名称应当以max为前缀,例如maxScore。如果是最小值,则是以min为前缀,例如minScore;
  • 如果变量中存储的是一系列数字的和,那么变量的名称应当以total为前缀,例如totalIncome;
  • 如果变量中存储的是数组的长度,那么变量的名称可以用numberOf为前缀,例如numberOfUsers。

字符串变量的命名规则

  • 如果表达的是人名、品牌名、公司名、数据库中的表名,那么变量的名称可以用单词name结尾,例如customerName、brandName、companyName;
  • 如果表达的是按键或按钮上刻着的文字、纸质表格或电子表单上输入框左侧的简短说明,那么变量的名称可以用单词label结尾,例如buttonLabel;
  • 不允许使用单词content

函数名

  • 函数的名称应当由动词和名词组成,例如readFile、writeFile;
  • 如果函数的功能是将参数转换为另一种形式的输出(比如进制转换、币种转换),那么函数的名称应当以单词to为前缀,例如toDollar、toHexadecimal;
  • 如果函数的功能是检验参数并返回一个布尔值,那么函数的名称应当以单词check为前缀,例如checkIsDirectory、checkIsExecutable;
  • 如果函数的功能是“计数”,那么函数的名称应当以单词count为前缀,并且其中被计数的对象应当为复数形式,例如countPaidOrders。

构造型函数的命名规则

  • 如果表达的是从无到有地创造一个对象,那么函数名可以用create作为前缀,例如createObject;
  • 如果表达的是将一些输入原封不动地放在一起(可能输入之间添加了其它东西)创造出一个对象,那么函数名可以用make作为前缀,例如makeFloor。进一步地,如果函数不改变输入的相对顺序,那么函数名可以用concat,例如concatString;
  • 如果函数会将根据输入创造出具有不止一个层级的对象,那么函数名可以用build作为前缀,例如buildBinarySearchTree。

修改型函数的命名规则

  • 如果函数负责更新数据库中的记录,那么函数名应当以单词update为前缀;
  • 如果函数修改的是一些可枚举的状态,那么函数名应当以单词change为前缀。

类名

  • 类的名称应当采用capital case的命名风格,例如DatabaseConnection;
  • 类的名称应当以一个名词结尾;
  • 如果类的存在是为了使用某种设计模式,那么类名应当可以反映在设计模式中所处的位置,例如在State模式中,代表具体状态的类的名称可以是InitialState、UnpaidState。

参考资料

The art of naming variables
Google JavaScript Style Guide
Letter case

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
jquery随意添加移除html的实现代码
Jun 21 Javascript
Javascript无阻塞加载具体方式
Jun 28 Javascript
qq悬浮代码(兼容各个浏览器)
Jan 29 Javascript
js+html5通过canvas指定开始和结束点绘制线条的方法
Jun 05 Javascript
阿里巴巴技术文章分享 Javascript继承机制的实现
Jan 14 Javascript
jQuery图片左右滚动代码 有左右按钮实例
Jun 20 Javascript
jQuery中的AjaxSubmit使用讲解
Sep 25 Javascript
详解AngularJS2 Http服务
Jun 26 Javascript
js实现随机点名系统(实例讲解)
Oct 18 Javascript
vuex操作state对象的实例代码
Apr 25 Javascript
angularjs $http调用接口的方式详解
Aug 13 Javascript
Node绑定全局TraceID的实现方法
Nov 14 Javascript
微信域名检测接口调用演示步骤(含PHP、Python)
Dec 08 #Javascript
vue实现数字动态翻牌的效果(开箱即用)
Dec 08 #Javascript
详解小程序BackgroundAudioManager踩坑之旅
Dec 08 #Javascript
vue 实现LED数字时钟效果(开箱即用)
Dec 08 #Javascript
Vue学习笔记之计算属性与侦听器用法
Dec 07 #Javascript
Vue+Node实现商品列表的分页、排序、筛选,添加购物车功能详解
Dec 07 #Javascript
JQuery样式与属性设置方法分析
Dec 07 #jQuery
You might like
玛琪朵 Macchiato
2021/03/03 咖啡文化
Cannot modify header information错误解决方法
2008/10/08 PHP
解析PHP留言本模块主要功能的函数说明(代码可实现)
2013/06/25 PHP
php判断正常访问和外部访问的示例
2014/02/10 PHP
PHP中的替代语法介绍
2015/01/09 PHP
DOM 脚本编程中的兄弟节点
2009/10/31 Javascript
javascript返回顶部效果(自写代码)
2013/01/06 Javascript
javascript实现文字图片上下滚动的具体实例
2013/06/28 Javascript
javascript仿php的print_r函数输出json数据
2013/09/13 Javascript
jquery实现滑动图片自己测试的例子
2013/11/05 Javascript
angularjs指令中的compile与link函数详解
2014/12/06 Javascript
分享一个自己写的简单的javascript分页组件
2015/02/15 Javascript
javascript弹出窗口实现代码
2015/11/12 Javascript
JavaScript通过HTML的class来获取HTML元素的方法总结
2016/05/24 Javascript
jQuery制作网页版选项卡
2016/07/28 Javascript
JavaScript实现二叉树的先序、中序及后序遍历方法详解
2017/10/26 Javascript
vue项目中使用lib-flexible解决移动端适配的问题解决
2018/08/23 Javascript
vue实现简单的星级评分组件源码
2018/11/16 Javascript
jquery获取img的src值实例介绍
2019/01/16 jQuery
微信小程序 image组件遇到的问题
2019/05/28 Javascript
vue+elementUi图片上传组件使用详解
2019/08/20 Javascript
Python如何判断数独是否合法
2016/09/08 Python
Python实现绘制双柱状图并显示数值功能示例
2018/06/23 Python
Python实现爬虫抓取与读写、追加到excel文件操作示例
2018/06/27 Python
Flask框架Flask-Login用法分析
2018/07/23 Python
Django之编辑时根据条件跳转回原页面的方法
2019/08/21 Python
Python 多线程其他属性以及继承Thread类详解
2019/08/28 Python
pip install 使用国内镜像的方法示例
2020/04/03 Python
Python reduce函数作用及实例解析
2020/05/08 Python
PyCharm配置anaconda环境的步骤详解
2020/07/31 Python
如何在vscode中安装python库的方法步骤
2021/01/06 Python
班子群众路线教育实践个人对照检查材料思想汇报
2014/09/30 职场文书
公务员检讨书
2014/11/01 职场文书
第一书记观后感
2015/06/08 职场文书
nginx配置ssl实现https的方法示例
2021/03/31 Servers
雄兵连:第三季先行图公开,天使恶魔联合,银河之力的新力量
2021/06/11 国漫