小驼峰命名法要求变量名首字母小写、后续单词首字母大写,如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
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











