JavaScript标识符须以字母、下划线或美元符开头,后续可含字母数字等,禁用保留字且区分大小写;推荐小驼峰命名法(如firstName),因其被ECMAScript、主流框架及ESLint广泛采用,兼顾可读性、一致性与输入效率。

JavaScript标识符命名需遵循语法规则,同时兼顾可读性与团队协作一致性;小驼峰命名法(camelCase)是变量、函数等最常用且被广泛推荐的命名风格。
标识符的基本语法规则
JavaScript标识符用于命名变量、函数、参数、属性等,必须满足以下条件:
- 首字符必须是字母(a–z 或 A–Z)、下划线(_)或美元符号($)
- 后续字符可为字母、数字(0–9)、下划线或美元符号
- 不能是 JavaScript 保留字(如 if、return、class 等)
- 区分大小写: userName 和 username 是两个不同标识符
为什么推荐小驼峰命名法
小驼峰命名法指首个单词小写,后续每个单词首字母大写,不使用空格或分隔符,例如 firstName、isValidEmail、renderUserProfile。它被 ECMAScript 规范示例、主流框架(React、Vue)及 Linter 工具(ESLint)默认采纳,原因包括:
- 避免下划线命名(first_name)在部分旧环境或正则中引发歧义
- 比大驼峰(PascalCase)更明确区分构造函数(如 User)与普通变量/函数
- 键盘输入高效,无须切换 Shift 或输入符号,降低拼写错误率
常见场景下的命名建议
结合语义与用途,小驼峰可灵活延伸,但需保持内部一致:
立即学习“Java免费学习笔记(深入)”;
- 变量与常量:普通变量用小驼峰(apiUrl、isLoaded);常量若为全局配置,可用全大写下划线(MAX_RETRY_COUNT),但模块内局部常量仍建议小驼峰(defaultTimeout)
- 函数名:动词开头,体现行为(fetchUserData、validateInput);布尔返回值函数宜以 is、has、can 开头(isEmailValid、hasPermission)
- 对象属性与方法:统一用小驼峰(user.profileImage、element.classList.add()),避免混用中划线(user-profile-image)——这在 JS 中非法,仅适用于 HTML 属性
需要避免的命名习惯
即使语法合法,以下方式会降低代码质量:
- 单字母变量(a、fn),除非在极短作用域内(如循环索引 i、j)
- 模糊缩写(usr 代替 user,tmp 代替 temporaryData)
- 拼音或中英文混杂(userName ✅,userNameZh ❌,应改用注释说明语言上下文)
- 数字开头或纯数字(3dModel 语法错误;应写作 model3d)










