变量命名应使用小驼峰式(如userName)、语义准确(如currentUserName而非userName)、避免泛化词(如data),let变量体现动态性,const常量全大写下划线(如API_TIMEOUT),布尔变量以is/has/can/should开头,全项目统一风格。

变量命名的核心是让名字自己说话——看到变量名,就能立刻明白它存的是什么、用在哪儿。不靠猜,不靠翻上下文,一眼清楚。
用小驼峰式(camelCase)写变量名
这是 JavaScript 社区最通用的约定:第一个单词全小写,后续每个单词首字母大写,中间不加空格或下划线。
-
推荐:
userName、currentOrderTotal、isSubmitted、maxRetryCount -
不推荐:
username(不易区分单词边界)、user_name(下划线风格多用于常量或后端)、UserName(首字母大写容易和类名混淆)
名字要准确表达语义,宁长勿歧义
别为了“简洁”牺牲可读性。短不是目标,清晰才是。
- 用
ourPlanetName而不是planet——后者可能是火星、游戏星球,也可能是抽象概念;前者明确指“我们这颗星球” - 用
currentUserName而不是userName——除非整个文件只处理当前用户,否则userName可能指注册用户、历史用户、管理员等 - 避免泛泛而谈的词:
data、info、value、temp,除非上下文极窄且无歧义
根据用途选声明方式,再配对应命名习惯
声明关键字和命名风格要协同,传递更丰富的意图:
立即学习“Java免费学习笔记(深入)”;
-
let声明的变量:预期会重新赋值,名字体现其动态含义,如pendingTaskCount、nextPageUrl -
const声明的常量:值不会变,推荐全大写+下划线,如API_TIMEOUT、MAX_FILE_SIZE(注意:对象/数组用const声明,内容仍可修改,只是引用不可变) -
var已不推荐使用——作用域行为易出错,现代代码统一用let或const
保持项目内风格统一
一个人写得再规范,团队不一致也会降低协作效率。建议在项目初期就明确并文档化几条底线规则:
- 所有变量用小驼峰
- 布尔变量以
is、has、can、should开头,如isLoading、hasPermission - 函数名也用小驼峰,但动词开头更自然,如
fetchUserData、validateEmail - 避免匈牙利命名法(如
strName、intCount),JS 是动态类型,这类前缀既冗余又易过时



















