写ref="/tag/137/" style="color:#874873;font-weight:bold;">JavaScript时,很多人只关心功能能不能跑通,却忽略了代码的可读性和长期维护性。比如你和同事共同开发一个网页表单验证功能,他用驼峰命名,你用下划线,变量名一会儿大写一会儿小写,时间一长,别说是改bug,看懂都费劲。这时候,统一的JavaScript编码标准就显得特别重要。
变量和函数命名要有意义
别图省事用 a、b、i 这种名字,除非是循环计数器。变量名要能一眼看出用途。比如用户年龄就叫 userAge,不要叫 ua 或 ageInfo 这种模糊的。
const userAge = 25;
function validateEmail(email) {
return email.includes('@');
}
使用一致的缩进和花括号风格
有人喜欢把左花括号放在行尾,有人喜欢另起一行。只要团队统一就行。常见的风格是K&R风格:
if (isLoggedIn) {
showDashboard();
} else {
redirectToLogin();
}
保持缩进统一,用两个或四个空格都可以,但别混着来。编辑器里开启显示空白字符,能帮你快速发现格式问题。
避免全局变量
在页面顶部直接声明一堆变量,很容易造成命名冲突。比如你在写购物车逻辑,定义了个 total,结果广告脚本也用这个名,那计算就乱套了。尽量用 let 和 const 在块级作用域中声明变量。
function calculateTotal(items) {
const taxRate = 0.1;
const total = items.reduce((sum, item) => sum + item.price, 0);
return total * (1 + taxRate);
}
注释不是越多越好
好的代码自己会说话。比如 calculateTotal() 这种函数名,基本不用额外解释。但如果是处理特殊业务逻辑,比如“根据地区调整税率”,那就该加一行注释说明原因。
// 某些地区法定最低税率为8%,即使计算低于此值也要按8%征收
if (calculatedRate < 0.08) {
return 0.08;
}
使用ES6+语法提升可读性
现在的浏览器基本都支持箭头函数、解构赋值、模板字符串这些特性。用起来不仅简洁,还能减少出错概率。比如以前拼接字符串容易漏引号,现在可以直接用反引号。
const name = '张三';
console.log(`欢迎回来,${name}!`);
再比如从接口获取数据时,解构能让代码更清爽:
const { username, email, profile } = userData;
console.log(username);
善用代码检查工具
人工盯着代码找格式问题太累。可以配置 ESLint,在保存文件时自动提示不符合规范的地方。比如你忘了加分号,或者用了未声明的变量,它会立刻提醒。配合 Prettier 还能一键格式化整个文件。
很多公司项目里都内置了这些工具,刚接手代码时可能觉得限制多,但用习惯了,反而会觉得没有它们才不自在。