企业级javascript变量命名须用小驼峰、语义化名词开头,布尔值加is/has/can前缀,数组用复数、数字含count/length等,常量全大写下划线,私有变量单下划线前缀。

企业级 JavaScript 项目对变量命名的要求,核心是可读性、一致性、可维护性——不是越短越好,而是让任何团队成员一眼看懂“它是什么、存什么、怎么用”。下面按实际开发高频场景给出明确、可落地的规范。
变量名必须用小驼峰(camelCase),且以语义化名词开头
这是全团队统一的基础。首字母小写,后续单词首字母大写,不使用下划线、连字符或数字开头。
-
✅ 正确示例:
userEmail、maxRetryCount、isModalOpen、activeTabId -
❌ 常见错误:
user_email(蛇形)、UserEmail(帕斯卡,属类名范畴)、1stAttempt(数字开头)、flag(无语义) - 前缀必须是名词:表示数据本质,比如
userName(字符串)、userList(数组)、userConfig(对象)——避免用setUser或getUser命名变量(那是函数)
布尔值变量强制加 is / has / can 前缀
这类变量只表达状态,命名必须自带“真假感”,杜绝 loading、success 这类孤立词。
-
isLoading、hasPermission、canSubmit—— 读起来就是一句完整判断 - 避免
loadStatus(类型模糊)、done(语义不清)、error(应为hasError或isError) - 注意区分:
isMounted(是否已挂载)、hasFetched(是否已请求过)、canEdit(是否有编辑权限)
按数据类型隐含后缀或结构特征
不强制加后缀,但鼓励通过命名自然体现类型,降低阅读成本:
-
数组:用复数名词,如
users、filters、errorMessages;必要时可加List(roleList)或Items(cartItems) -
数字类:用
Count、Length、Index、Timeout等词,如totalCount、retryCount、debounceDelay -
字符串类:含
Name、Title、Url、Path、Id,如pageTitle、apiUrl、userId -
对象/配置:用
Config、Options、Settings、Data,如formConfig、chartOptions
常量、私有变量与特殊标识
企业项目中需快速识别“不可变”和“内部使用”变量:
-
常量全大写下划线:
MAX_RETRY_COUNT、API_TIMEOUT_MS、DEFAULT_PAGE_SIZE -
私有变量(约定)加单下划线前缀:
_internalCache、_pendingRequests(仅作提示,非语法保护) -
避免 $ 开头:防止与 jQuery、模板引擎等冲突;也避免纯下划线开头(如
__data)——易与 Babel/webpack 内部标识混淆
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











