Java标识符首字符限字母、_或$，后续可加数字，禁用空格、-、.等符号；class等为保留字不可用；命名须遵驼峰等规范，否则引发协作与运行期问题。
Java标识符哪些字符能用、哪些一写就报错
Java标识符不是随便起个名字就能编译通过的——它有硬性语法边界。开头只能是字母（A-Z/a-z）、_ 或 $；后续字符可加数字（0-9），但绝不能以数字开头，比如 123id 直接编译失败。
-
userName、_count、$internal都合法，但后两者不推荐——_开头常被IDE识别为“内部变量”，$多用于编译器生成代码（如匿名内部类名Outer$1.class） - 含中文或 emoji 的标识符（如
姓名、user✅）语法上允许，但需确保源文件编码为 UTF-8，且团队工具链（CI/CD、静态扫描）普遍不支持，实际项目中等于自埋雷 - 空格、
-、.、@、%、#这些符号哪怕只出现一次，立刻触发error: illegal character
为什么 class、int、true 不能当变量名
它们不是“普通单词”，而是 Java 语言层面的保留项：class 是关键字（keyword），true、false、null 是字面量（literal）。编译器在词法分析阶段就直接拦截，不会进入语义检查。
- 写
int class = 5;→ 报错error: not a statement或error: <identifier> expected</identifier>，因为class被当成类型声明关键字，后面却跟了变量名 - 拼错关键字反而更危险：比如
defualt（少一个l）完全合法，但读代码时大脑会自动纠正成default，导致逻辑理解偏差 - SQL 关键字（如
order、group）虽非 Java 关键字，但若用作 JPA 实体字段名，可能引发 Hibernate 解析异常或数据库方言冲突
驼峰命名不是风格选择，是工程协作刚需
小驼峰（userName）、大驼峰（UserName）、全大写下划线（USER_NAME）这三类命名，在 Java 里对应不同语义角色。混用不是“个性”，是让同事调试时多花三倍时间定位问题。
- 类/接口必须大驼峰：
HttpClientFactory✅，httpclientfactory❌（违反约定，IDE 可能不提示，但 Checkstyle/SonarQube 直接标红） - 变量/方法必须小驼峰：
calculateTotalPrice()✅，CalculateTotalPrice()❌（首字母大写会被误判为构造方法） - 常量必须全大写+下划线：
MAX_RETRY✅，maxRetry❌（private static final int maxRetry = 3;在严格规范项目里属于“技术债”） - 包名必须全小写+点分隔：
com.example.auth✅，com.example.Auth❌（大小写敏感，Linux 环境下可能导致类加载失败）
IDE 不报错 ≠ 命名合规，真正坑在运行期和协作链路
IntelliJ 或 Eclipse 能拦住 123name 和 class，但对 userName 和 username、HTTPClient 和 HttpClient 完全沉默——而这些才是真实项目中最常引发歧义的地方。
立即学习“Java免费学习笔记（深入）”；
-
HTTPClient看似只是大小写差异，但对接 Swagger 文档时，JSON 字段名可能变成hTTPClient（Jackson 默认按驼峰规则映射），后端收不到参数 - 用拼音缩写如
zhanghao（账号）代替account，新人接手时无法关联业务含义，搜索zhanghao也找不到相关权限模块 - 测试类命名为
TestUser，但没加Test后缀或@RunWith注解，Maven Surefire 插件直接跳过执行，CI 流水线显示“测试通过”实则零覆盖
最麻烦的从来不是编译错误，而是那些编译通过、单元测试绿、上线后才暴露的命名歧义——它不打断你写代码，但会让所有人读代码时反复确认“这到底指什么”。
