驼峰命名法和避开保留关键字是变量命名最基础关键的两项要求：小驼峰用于变量函数（如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 更有价值。工具可以检查语法，但语义只能靠人来把关。
