Node.js 编码规范与最佳实践

语法细节与命名规范

在调用函数时，函数名与左侧括号之间不应保留空格。

函数名与参数列表之间无需空格，而其他语法元素与左括号之间则需保留一个空格。

所有变量及属性名称应统一采用小驼峰式命名法。

代码缩进统一采用两个空格，字符串引号统一使用单引号。

关联数组的键名若不含空格或非法字符，则无需添加引号；仅在键名包含空格或非法字符时才使用引号。

语句结构与运算符限制

禁止将具有不同逻辑目的的语句合并书写在同一行。

句末分号不可省略，即使单行仅包含一个语句，也必须显式添加分号。

禁止使用自增（++）和自减（--）运算符，应改用 += 和 -= 运算符进行数值更新。

禁止使用相等（==）运算符，必须统一使用严格相等（===）运算符进行比较。

变量声明与函数定义顺序

所有变量的声明语句必须集中放置在函数体的最开头位置。

所有函数的定义必须位于其被调用或使用的代码之前。

对象创建与继承最佳实践

建议为构造函数和回调函数显式命名，以便在调试过程中获取更清晰的调用栈信息。

对象成员函数应通过原型（prototype）进行定义，而属性应在构造函数内部初始化，最后使用 new 关键字实例化对象。

应尽量避免复杂的继承关系；若需实现继承，推荐使用 util 模块提供的 inherits 函数，例如通过 util.inherits(A, B) 实现 A 对 B 的继承。

参考资料

相关参考资料如下：

《Node.js开发指南》附录B（作者：BYVoid）

《Javascript编程风格》（作者：阮一峰）