可读性高的Java代码以清晰表达意图为核心：命名直白准确、方法单一短小、善用空行缩进、注释阐明“为什么”而非“是什么”，从而提升可维护性与协作效率。
写出可读性高的 Java 代码，核心不是追求炫技或压缩行数，而是让别人（包括未来的自己）能快速理解“这段代码在做什么、为什么这么做、边界在哪”。可读性是维护性、协作效率和长期项目健康度的基石。
命名要直白，不靠注释猜意图
变量、方法、类名应准确反映其职责和含义，避免缩写、拼音、无意义前缀（如 strName、temp、obj）。方法名优先用动词短语，清晰表达行为；布尔变量/方法名用 is、has、can 开头，一眼识别真假语义。
- 好： isUserActive()、calculateDiscountedPrice()、pendingOrderCount
- 差： checkSta()、getVal()、tmp
方法要小而专，一个方法只做一件事
单个方法长度建议控制在 20 行以内（不含空行和简单 getter/setter），职责越单一，越容易理解、测试和复用。遇到逻辑分支多、步骤长的情况，主动拆分成多个小方法，并用有意义的名字封装意图。
- 把 processOrder() 拆成 validateOrder()、reserveInventory()、sendConfirmationEmail()
- 避免在方法内部嵌套超过 3 层 if/for，深层嵌套时提取为独立方法或使用卫语句（guard clause）提前返回
善用空行与缩进，视觉节奏比代码密度更重要
合理空行分隔逻辑段落（如不同业务步骤之间），保持每行只做一件事。运算符两侧、逗号后加空格，增强扫描友好度。IDE 自动格式化（如 IntelliJ 的 Ctrl+Alt+L）应作为日常习惯，而非事后补救。
立即学习“Java免费学习笔记（深入）”；
- 写成 if (user != null && user.isActive()) {，而不是 if(user!=null&&user.isActive()){
- 长参数列表换行时，每个参数独占一行并缩进对齐，比挤在一行更易定位
注释讲清楚“为什么”，而不是“是什么”
代码本身应尽量自解释。避免重复代码语义的注释（如 // 将 count 加 1），这类信息直接看 count++ 更快。真正需要注释的是：特殊算法的选型原因、绕过某个 bug 的临时方案、违反直觉的设计取舍、外部依赖的隐含约束等。
- 值得写的注释示例：// 使用 AtomicInteger 而非 synchronized：此处高并发计数，需无锁性能
- 接口方法的 Javadoc 应说明前置条件、后置行为、异常场景，而非仅描述参数名
