JavaScript代码规范与风格详解

编写清晰、一致且可维护的JavaScript代码，远不止让程序运行起来那么简单——它关乎团队协作效率与长期项目健康度；本文系统梳理了从变量命名（camelCase/UPPER_CASE）、声明优先级（const优于let/var）、代码格式（缩进、换行、大括号风格）到函数设计（单一职责、短小精悍）、模块导出、错误处理及注释原则等核心实践，并强调通过ESLint与Prettier工具链将规范落地为自动化保障，真正实现“人能读懂、机器能执行、团队能协同”的高质量编码文化。

写JavaScript代码不只是让机器能执行，更重要的是让人能看懂。良好的代码风格能提升可读性、降低维护成本、减少错误。以下是一些实用的规范建议，适合团队协作和个人项目。

变量与命名

变量名要清晰表达用途，避免缩写或无意义的字符。

• 使用camelCase命名变量和函数，如userName、getUserInfo
• 常量用UPPER_CASE，多个词用下划线分隔，如MAX_RETRY_COUNT
• 布尔类型可加is、has、should前缀，如isLoading、hasPermission
• 避免使用let和var，优先用const声明不变的值

代码结构与格式

统一的格式让代码看起来整洁一致。

• 使用4个空格缩进（或2个，根据团队约定），不要用Tab
• 每行代码不超过80~100个字符，过长应换行
• 大括号放在同一行，遵循1TBS风格
• 控制语句（if、for、while）必须带大括号，即使只有一行
• 函数定义后留一个空行，不同逻辑块之间用空行分隔

示例：

function calculateTotal(items) {
    const taxRate = 0.08;
    let total = 0;
<pre class="brush:php;toolbar:false"><code>for (let i = 0; i &lt; items.length; i++) {
    total += items[i].price;
}

return total * (1 + taxRate);</code>

}

函数与模块设计

函数应该专注单一任务，易于测试和复用。

• 函数长度尽量控制在20行以内
• 参数不超过3个，过多时考虑传入对象
• 优先使用箭头函数处理简单回调，但保持一致性
• 模块导出清晰的接口，避免暴露内部实现

推荐：

const formatPrice = (amount, currency = 'CNY') => {
    return new Intl.NumberFormat('zh-CN', { style: 'currency', currency }).format(amount);
};

错误处理与注释

健壮的代码需要考虑异常情况，注释应解释“为什么”而不是“做什么”。

• 异步操作必须处理reject，使用try/catch或.catch()
• 自定义错误要有明确信息，方便调试
• 注释重点说明复杂逻辑、业务规则或临时方案
• 避免过时或冗余注释，比如// 循环开始这类无意义内容

基本上就这些。坚持使用ESLint配合Prettier，能自动帮你维持风格统一。关键是团队达成一致，并通过工具落实，而不是靠人盯人。

理论要掌握，实操不能落！以上关于《JavaScript代码规范与风格详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！