VS Code Java格式化默认使用Eclipse JDT LS，需显式启用java.format.enabled为true，并正确配置相对或绝对路径的eclipse-formatter.xml（不含中文、空格及file://前缀），文件须置于工作区根目录或其子目录，修改后需重载窗口生效。
VS Code 默认用 Eclipse 格式化器，但必须显式启用且路径配置稍有不慎就失效。 它不依赖 Prettier 或 google-java-format，而是通过 JDT LS（Java Language Server）加载 eclipse-formatter.xml 文件来执行格式化。你看到的“Eclipse 风格”，本质是复用 Eclipse IDE 的那套规则引擎，不是外观模仿。
java.format.enabled 必须为 true 才触发格式化
很多人配完路径却没反应，第一原因是这个开关默认关闭。VS Code 的 Java 插件（redhat.java）不会自动开启格式化，哪怕你装了 Java Extension Pack 也一样。
-
java.format.enabled必须设为true—— 在 Settings UI 搜索该配置项并勾选，或在settings.json中手动加一行："java.format.enabled": true - 仅靠
editor.formatOnSave不够：如果java.format.enabled是 false，保存时根本不会调用 Java 格式化器 - 注意作用域：工作区设置（
.vscode/settings.json）优先级高于用户设置，多项目混用时容易被覆盖
自定义 formatter.xml 路径必须满足三个硬性条件
JDT LS 对路径极其敏感，错一个字符、少一个斜杠都会静默失败（无报错，也不格式化）。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 路径不能含中文或空格：例如
/Users/张三/project/.vscode/formatter.xml→ 触发URI is not hierarchical错误 - 不能加
file://前缀：VS Code 不识别这种 URI，只接受相对路径（如./.vscode/formatter.xml）或绝对路径（如/Users/name/project/.vscode/formatter.xml） - 文件必须放在 workspace root 或其子目录下：放在
src/或lib/里，JDT LS 根本找不到 —— 它只扫描 workspace root 及其直接子路径，不递归
brace_position_for_* 类规则要批量改才生效
想让 if、for、class 等结构的左花括号换行（即 Eclipse 的 “Next line” 风格），不能只改一两个 setting，必须统一设为 end_of_line。
- 关键配置项名都带
brace_position_for_*，比如：org.eclipse.jdt.core.formatter.brace_position_for_method_declaration - 值必须是字符串
"end_of_line"（带英文双引号），不是end_of_line或true - 漏掉任意一个（如忘了
brace_position_for_lambda_body），对应语法块就会回退到默认风格（可能是 same_line） - 修改后需重启 VS Code 或重载窗口（
Developer: Reload Window），热加载不生效
最易被忽略的是：即使所有配置都对，若项目里同时启用了其他 Java 格式化插件（比如 google-java-format 扩展），它们会和 redhat.java 冲突，导致格式化行为不可预测。务必检查 settings.json 中没有重复指定 editor.defaultFormatter 给 Java 语言，只留 redhat.java 自己的机制接管。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
