根本原因是将JAVA_HOME、java.home等本地绝对路径硬编码进.vscode/settings.json、.idea/misc.xml或pom.xml并提交至Git，导致跨机器失效；应将其加入.gitignore，改用环境变量占位（如${env:JAVA_HOME}）或通过maven-compiler-plugin统一声明java.version，确保JDK路径由各成员本地配置。
JDK路径写死在配置里，项目一换机器就编译失败，这是团队协作中最典型的“本地路径污染”问题。根本原因不是配置难，而是把JAVA_HOME、java.home这类值硬编码进.vscode/settings.json、.idea/misc.xml或pom.xml里，导致提交后别人拉下来直接失效。
为什么java.home不能写进.vscode/settings.json提交
VSCode 的settings.json一旦提交到 Git，所有成员都会继承你本机的绝对路径，比如"java.home":"/Users/you/jdk-17"。别人没有这个路径，Java扩展直接报“JDK not found”，连语法高亮都失效。更麻烦的是，这个文件常被 IDE 自动生成，容易误提交。
- 解决方案：把
.vscode/settings.json加进.gitignore，只保留团队通用配置（如"editor.tabSize"） - 例外情况：若必须共享 JDK 配置（如 CI 本地模拟），改用环境变量占位，例如
"java.home":"${env:JAVA_HOME}"，再配合文档说明需预设JAVA_HOME - 注意：
${env:...}仅在 VSCode 启动时读取，修改环境变量后需重启 VSCode 才生效
Maven 项目里如何让java.version不依赖本地JAVA_HOME
Maven 编译行为由maven-compiler-plugin控制，它读取的是source和target参数，而非系统JAVA_HOME。只要插件配置明确，哪怕你本机装着 JDK 8，也能强制用 JDK 17 编译——前提是构建机上真有那个版本。
- 在父
pom.xml中统一声明：17 - 绑定到插件：
org.apache.maven.plugins maven-compiler-plugin ${java.version} ${java.version} - 关键点：这个配置只管字节码级别，不指定具体 JDK 路径；实际用哪个 JDK 运行
mvn compile，取决于执行命令时的PATH或 CI 环境预装
IDEA 中避免JRE Home路径污染项目配置
IntelliJ 默认把 JRE 路径写死在.idea/misc.xml里，这个文件如果被提交，别人打开项目就会强制切换到你的 JDK 路径，甚至覆盖掉自己已配好的 SDK。
- 正确做法：把
.idea/misc.xml中的Ctrl+Alt+Shift+S）手动设置，该设置不落盘到项目文件 - 团队规范：在
.gitignore中加入.idea/misc.xml，但保留.idea/modules.xml和.idea/vcs.xml（它们不含路径信息） - 补救措施：若已误提交，运行
git checkout -- .idea/misc.xml回退，并提醒成员重置 Project SDK
真正需要关注的不是“怎么让路径生效”，而是“哪些路径必须由每个人自己配”。JDK 安装路径、IDE 的 JDK Home、VSCode 的 java.home —— 这些全是用户级配置，写死即埋雷。团队能统一的只有编译目标（java.version）、构建工具版本（maven-compiler-plugin）、以及运行约束（maven-enforcer-plugin）。其余一切，交给本地环境变量或 IDE 引导流程更安全。
