小驼峰命名的基本要求很明确：变量名首字母要小写，后面每个单词的首字母再大写，比如userAge。

像UserAge、user_age、userage这类写法，都不建议使用。至于布尔变量，通常优先采用is、has、can这类前缀，关键不只是形式统一，更要保证语义清晰、表达准确，同时尽量避免生硬缩写。

变量命名用小驼峰（camelCase），首字母小写，后续单词首字母大写，名字要能一眼看出用途。

变量命名的基本规范

变量名必须是小驼峰格式

这是最基础的一条，也是最容易被忽视的一条。拿“用户年龄”来说，写成 userAge 才是规范写法。

像 UserAge（大驼峰）、user_age（下划线）、userage（全小写无分隔）这几种，都不符合规范。

• 正确示例：userName、orderCount、isSubmitted、maxRetryTimes
• 错误示例：UserName、user_name、User_name、MAX_RETRY_TIMES

名字要真实反映含义和类型

不要使用缩写或模糊词。变量名应该让别人，包括未来的你，不用猜就能看懂。

• 用名词开头：如 productName、cartItems、apiUrl
• 带语义提示类型：数字类加 Count/Length/Index（如 itemCount）；布尔类加 is/has/can（如 isValid、hasPermission）；字符串类可含 Name/Title/Text（如 pageTitle）
• 避免单字母或简写：不用 u 代替 user，不用 cnt 代替 count

区分变量和函数，靠前缀词性

变量是“东西”，函数是“动作”。命名习惯上，两者应该有明显差别。

• 变量以名词为主：currentStep、defaultConfig、selectedOption
• 函数以动词开头：getUserData、validateForm、toggleMenu
• 布尔型变量优先用 is/has/should 开头，对应函数返回值也保持一致，比如 isOnline 和 checkOnline

特殊情况处理

这些细节也要注意

有些场景容易踩坑，命名时需要额外留意。

• ID 类字段统一用全小写 id，不写成 ID 或 Id（如 userId、productId）
• 私有属性或方法加前导下划线，但依然遵循小驼峰：_internalState、_handleClick
• jQuery 对象建议加 $ 前缀：$header、$modal，便于快速识别 DOM 引用
• 常量不是变量，用全大写下划线：API_TIMEOUT、DEFAULT_PAGE_SIZE

《夸克》非常好用的免费AI浏览器

下载APP查看