JavaScript变量命名采用小驼峰法,即首单词小写、后续单词首字母大写,适用于变量和函数;常量用全大写加下划线;布尔值以is/has/can/should开头;避免模糊词与非常规缩写,并通过ESLint等工具保障落地。

JavaScript 中变量命名用驼峰命名法,核心是让名字既准确又易读,同时符合团队和社区惯例。它不是单纯“加大小写”,而是有明确结构和适用边界的习惯。
小驼峰是变量和函数的默认写法
变量名第一个单词全小写,后续每个单词首字母大写,中间不加空格或下划线。这种形式被绝大多数 JavaScript 项目采用,编辑器自动补全也对此友好。
- 正确示例:`userName`、`totalAmount`、`isLoaded`、`fetchUserData`(函数也适用)
- 避免写法:`username`(无区分度)、`user_name`(下划线风格,非主流)、`UserName`(首字母大写,易与类混淆)
- 当单词超过两个时,仍保持逻辑断点清晰,比如 `maxRetryCount` 比 `maxretrycount` 或 `max_retry_count` 更易扫读
别把驼峰当成万能胶水
驼峰命名法适用于语义连贯、有明确业务含义的变量,但不适用于所有场景。强行套用反而降低可读性。
- 常量用全大写加下划线,如 `API_TIMEOUT`、`DEFAULT_PAGE_SIZE`,这是约定俗成的视觉提示
- 布尔型变量建议以 `is`、`has`、`can`、`should` 开头,如 `isLoading`、`hasPermission`,直接表达状态意图
- 循环变量或临时索引可简短,如 `i`、`idx`、`item`,不必硬凑驼峰;但一旦超出单作用域,就该回归完整命名
命名要先想清楚“它是什么”,再决定怎么写
驼峰只是表达形式,真正提升规范的是背后对数据含义的判断。一个好名字 = 类型 + 作用 + 上下文。
- 避免模糊词:`data`、`info`、`value` 单独出现时几乎没信息量;换成 `userData`、`userInfo`、`selectedValue` 就立刻具体
- 注意单复数:`userList` 表示数组,`currentUser` 表示单个对象,这点靠驼峰结构自然体现,无需额外注释
- 缩写需通用且无歧义:`btn`(button)、`el`(element)可接受;但 `usr`(user)、`cnt`(count)在团队中可能引发理解成本,不如写全
工具和协作让驼峰真正落地
光靠自觉难长期坚持,需要机制辅助。
- 用 ESLint 配置 `camelcase` 规则,自动拦截非法命名,CI 流程中卡住不合规提交
- 在团队代码规范文档里明确示例,比如规定 “API 响应数据统一用 `apiResponseData` 而非 `res` 或 `dataObj`”
- 新人 PR 中重点检查变量命名是否与已有模式一致,比语法错误更值得花时间对齐
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











