驼峰命名法和避开保留关键字是变量命名最基础关键的两项要求:小驼峰用于变量函数(如userName),大驼峰用于类名(如UserInfo);必须避开if、class等关键字,误用直接报错;还需规避数字开头、下划线伪私有、$符号及仅靠大小写区分等陷阱。

驼峰命名法和避开保留关键字,是变量命名中最基础也最关键的两项要求。写错变量名不光影响可读性,还可能直接导致语法错误或运行异常。
驼峰命名法分大小写场景
小驼峰(lower camel case)用于变量、函数、方法名:首单词全小写,后续单词首字母大写,比如 userName、maxRetryCount、isAvailable。大驼峰(upper camel case)专用于类名、接口名、构造函数,如 UserInfo、HttpClient、ApiConfig。同一项目中混用大小驼峰会降低一致性,建议严格区分用途。
保留关键字必须彻底避开
每种语言都有固定的关键字列表,它们已被语言本身占用,不能用作变量名。例如:if、for、class、return、int、def、async 等。Python 中可用 import keyword; print(keyword.kwlist) 查看全部;Java 和 JavaScript 的关键字列表在官方文档中明确列出。误用关键字会直接报错,不是警告。
常见命名陷阱要主动绕开
- 名字里含数字时,确保不以数字开头,user1 可以,1user 不合法
- 避免下划线开头的“伪私有”写法用于普通变量,如 _temp 在 Python 中有约定含义,随意使用易引发误解
- 不要用 $ 符号开头,虽然技术上多数语言允许,但实际开发中基本只留给编译器或框架生成代码使用
- 别依赖大小写差异来区分相似名,比如 name 和 Name,容易拼错且不利于协作审查
命名本质是沟通,不是凑规则
规范再严,目的都是让别人(包括未来的你)一眼看懂意图。与其纠结 userDataList 还是 userListData,不如确认它是否真实反映数据结构和用途。一个清晰的 activeOrderCount 比缩写成 aoc 或模糊的 tempNum 更有价值。工具可以检查语法,但语义只能靠人来把关。

















