Java代码规范核心是命名、格式与空行协同:用4空格缩进、统一括号风格、逻辑段间空行分隔、字段与方法间留白、布尔方法以is/has命名,配合IDE统一格式化。

Java代码块的规范不是细枝末节,而是直接影响他人能否快速看懂、安心修改、安全扩展的核心环节。写得清楚,比写得快更重要。
方法内部用空行分隔逻辑段
一个方法里如果堆着变量声明、校验逻辑、主业务处理、结果封装、日志记录,全挤在一起,阅读负担就很大。空行是免费的“视觉标点”,能自然划分关注区域。
- 字段声明与首条语句之间加一行
- 输入校验(如参数非空、范围检查)完成后空一行
- 主业务逻辑块前后各留空行,尤其当它包含嵌套循环或复杂条件时
- 返回前的日志、清理、状态更新等收尾操作,单独成段并前置空行
类成员之间保持清晰间距
字段、构造方法、普通方法、静态工具方法——它们职责不同,混在一起容易误判调用关系或初始化顺序。合理空行让类结构像目录一样一目了然。
- 每个字段声明后不空行,但字段块与下一个构造方法/方法之间空一行
- 构造方法之间、方法与方法之间统一空一行
- 静态方法建议与实例方法用空行隔开,便于识别工具边界
- getter/setter这类成对方法可紧邻,但与其前后其他方法仍需空行
缩进与括号风格要始终如一
4个空格缩进是Java社区事实标准,Tab字符易在不同编辑器中错位,必须禁用。大括号换行位置虽有争议,但团队内必须统一:要么Allman风格(左括号独占一行),要么K&R风格(左括号跟在语句后),不可混用。
立即学习“Java免费学习笔记(深入)”;
- if、for、while、try等控制结构,即使单行体也强制换行+缩进,避免后期补逻辑时漏掉大括号
- lambda表达式参数多于1个或逻辑稍长时,用换行+缩进提升可读性,不要硬塞一行
- 方法参数列表过长时,每参数独占一行,对齐参数名或类型,而非简单折行
命名+格式+空行,三者协同才真正起效
再好的空行,配上模糊的变量名(比如tmp、data、flag)或混乱的缩进,依然难以维护。命名体现意图,格式建立节奏,空行提供呼吸感——三者缺一不可。
- 布尔方法用isRunning()、hasPermission(),不用checkRunning()
- 字段名带业务含义,如maxRetryCount优于retryTimes,后者易被误解为已重试次数
- IDE自动格式化必须开启,并导入团队统一的code style配置文件,不靠人眼盯



















