《阿里巴巴java开发手册》规定类成员应按“静态→实例”顺序排列：静态变量（public static final→private static final→非final）→静态块→静态方法（工具类优先）→实例成员；ide需配置规则并统一共享。
阿里Java开发规约（《阿里巴巴Java开发手册》）对类成员的排列顺序有明确建议，其核心目标是提升代码可读性与团队协作效率。静态变量和静态方法的排布不是随意的，需遵循“由上至下、由粗到细、由静态到实例”的逻辑脉络。
静态变量按访问权限+是否常量分组排序
静态变量应统一放在类顶部（在类注释和类声明之后），并按如下优先级分组排列：
- public static final 常量（全大写，下划线分隔），如 PUBLIC_CONFIG_PATH
- protected static final 常量
- package-private static final 常量（即默认访问级别）
- private static final 常量（最常用，如 DEFAULT_TIMEOUT）
- 再之后是 static 非final 变量，同样按 public → protected → package-private → private 顺序排列（但应尽量避免使用非final静态变量）
静态方法紧随静态变量之后，按调用关系与职责分层
静态方法不按访问修饰符严格分组，而是以“被依赖者优先”为原则，即：工具性、基础性、无副作用的静态方法靠前；依赖其他静态方法或含业务逻辑的靠后。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 先放 工厂方法（如 of()、create()）
- 再放 校验/转换类方法（如 isValid()、toString()）
- 接着是 内部辅助静态方法（private static），尤其被多个静态方法共用的
- 避免将静态方法穿插在实例方法之间；也不应把静态方法放在实例变量之后
不与实例成员混排，且禁止“静态块”干扰主线顺序
静态初始化块（static {}）虽属静态范畴，但规约建议它**紧挨在静态变量定义之后、静态方法之前**，作为变量初始化的延续。它不可出现在静态方法中间或实例成员之后。
- 若存在多个静态块，应合并为一个，保持语义连贯
- 静态块中只做简单赋值或轻量初始化；复杂逻辑应抽取为 private static 方法并在块中调用
- 实例变量、构造器、普通方法、getter/setter 等一律排在所有静态成员之后
IDE可自动遵守，但需正确配置模板
IntelliJ IDEA 和 Eclipse 均支持按规约排序，但默认不启用。需手动开启并校准规则：
- IntelliJ：Settings → Editor → Code Style → Java → Arrangement → 添加规则，匹配 static final field、static field、static method，并设定顺序和访问控制分组
- 保存后，使用 Ctrl+Alt+L（Windows/Linux）或 Cmd+Option+L（macOS）即可格式化为合规顺序
- 建议将该配置导出为团队共享的 code-style.xml，纳入 Git 仓库统一管理
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
