java变量命名须见名知意，采用小驼峰、布尔加is/has前缀、常量全大写下划线；项目结构按反转域名分包，类名体现职责，包与命名均需统一规范以保障可读性、可维护性与协作效率。

Java变量命名不是随便起个名字的事，它直接关系到代码能不能被快速读懂、改得安心、协作顺畅。项目结构也不是目录堆叠，而是职责清晰、扩展有路、新人能上手的骨架。两者配合好了，项目才真正“立得住”。

变量命名：见名知意，不靠猜

Java变量名必须合法，更要专业。合法是底线，专业才是门槛。

• 用小驼峰（lowerCamelCase）：首单词小写，后续单词首字母大写，比如 userLoginCount、isEmailValid、maxRetryTimes；避免 userlogincount 或 UserLoginCount 这类模糊或错位写法。
• 布尔变量强制带语义前缀：is、has、can、should，如 isProcessing、hasPermission、canSubmitForm；禁用 flag、status、valid 这类无上下文的词。
• 常量全大写+下划线分隔：DEFAULT_TIMEOUT_MS、MAX_UPLOAD_SIZE_KB；不要写成 defaultTimeout 或 MaxUploadSize，否则无法与普通变量区分。
• 避免泛化词和缩写：不用 data、info、tmp、obj；也不用 usr（应为 user）、cnt（应为 count），除非是行业公认缩写（如 id、url、io）。

项目结构：包名分层，职责分明

一个Java项目的目录不是越深越好，而是每一层都该回答“它管什么”。

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• 包名全小写，用点分隔，按反转域名组织：com.example.order（不是 com.Example.Order 或 com_example_order）；模块再细分时用功能命名，如 com.example.order.controller、com.example.order.service、com.example.order.repository。
• 类名用大驼峰（PascalCase），且体现类型与职责：OrderController、OrderService、OrderRepository、OrderConfig；实现类加 Impl 后缀：OrderServiceImpl，若需多实现，中间插入能力描述：OrderServiceCacheImpl、OrderServiceAsyncImpl。
• 实体类用单数名词：Order、User、Product；DTO/VO类可加后缀明确用途：OrderCreateRequest、OrderSummaryResponse；避免 OrderDto 这种弱语义命名。
• 配置类统一用 Config 结尾：SecurityConfig、DatabaseConfig；工具类用 Utils 或 Helper：DateUtils、JsonHelper，不叫 Common 或 Util。

实战避坑：命名与结构常见误用

很多问题不是不会写，而是没意识到这些细节正在悄悄拖慢团队节奏。

• 包名混用大小写或下划线：如 com.example.UserService 在Linux系统下可能找不到类；com.example.user_service 违反Java约定，IDE和构建工具易报错。
• 变量名泄露实现细节：比如把 userList 改成 userArrayList —— 类型应由声明体现（List userList），名字只表达业务含义。
• 同模块内命名风格不一致：有的地方用 userName，有的用 username；有的接口叫 UserService，实现类却叫 UserServiceImpl，而另一个却叫 UserMgr —— 这会让代码像拼凑出来的，不是设计出来的。
• 忽略作用域暗示：局部变量 i 可用于简单循环，但 for (int i = 0; i 中若循环体复杂，就该换成 index 或 itemIndex；成员变量避免 temp、result 等无意义词，它们暴露的是“我不知道怎么命名”，不是“这是临时值”。

配套落地：让规范真正跑起来

光有规则不够，得嵌入开发流程里才不流于形式。

• 在 pom.xml 或 build.gradle 中集成 checkstyle 或 sonarqube，对变量名、包名、类名做静态检查，CI阶段失败即阻断提交。
• 新建模块或类时，用IDE模板（如IntelliJ Live Templates）自动补全标准命名，比如输入 svc 回车生成 XXXService 接口，svci 生成 XXXServiceImpl。
• Code Review清单中加入命名项：“变量是否见名知意？”、“包路径是否反映业务层级？”、“常量是否全大写？”——不是走形式，而是每次确认一次共识。
• 团队共享一份《命名速查表》，贴在Confluence首页：含典型场景示例（如“用户登录失败次数”→ loginFailureCount，“是否启用邮件通知”→ isEmailNotificationEnabled），新人三天内就能对齐。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南