Java项目统一开发环境需通过可执行配置落地：锁定JDK版本、使用Maven Wrapper、统一编码与换行符、提交IDE格式化规则及脚本，确保新成员git clone后五分钟内开箱即编译。
Java项目统一开发环境不是靠口头约定，而是靠可执行、可校验、可提交到代码库的配置落地。核心在于让 mvn clean compile 在任何成员机器上行为一致——这要求 JDK 版本、构建工具版本、编码格式、依赖解析策略全部收敛。
用 .tool-versions 或 java-toolchain 锁定 JDK 版本
不同 JDK（如 OpenJDK 17 vs Amazon Corretto 21）可能导致 javac 编译行为差异、String::isBlank 等 API 不可用，或 JRE 运行时抛出 IncompatibleClassChangeError。仅靠文档写“推荐 JDK 17”无效。
- 推荐在项目根目录放
.tool-versions（配合asdf使用）：java openjdk-17.0.2+8
- Maven 项目需显式声明 toolchain：在
pom.xml中配置maven-toolchains-plugin，并提供toolchains.xml指向本地 JDK 路径 - IDE（IntelliJ/Eclipse）必须禁用“自动检测 JDK”，改用项目指定的
JAVA_HOME或 toolchain 文件
强制统一 Maven 版本与 settings.xml 行为
mvn -v 输出的 Maven 版本不一致会导致插件解析失败（如 maven-compiler-plugin 3.11 要求 Maven ≥ 3.6.3），而本地 ~/.m2/settings.xml 若启用了私有镜像或 profile，可能让某位成员编译通过、其他人拉不到依赖。
- 在项目根目录放
mvnw（Maven Wrapper），并提交mvnw.cmd和.mvn/wrapper/maven-wrapper.jar - 将团队共用的
settings.xml放进config/maven/settings.xml，并通过-s config/maven/settings.xml显式传入（CI/CD 和本地脚本都走同一路径） - 禁止在
settings.xml中使用<activebydefault>true</activebydefault>，改用-P显式激活 profile
源码编码与行尾符必须由 Git 预设规则兜底
Windows 用户保存 UTF-8 文件默认带 BOM，Mac/Linux 默认 LF 换行，而 Java 编译器对 BOM 敏感（IllegalCharOnInput），且 IDE 自动换行符设置常被忽略。
立即学习“Java免费学习笔记（深入）”；
- 项目根目录必须含
.gitattributes：* text=auto eol=lf *.java text diff=java *.xml text *.properties text eol=lf
- 所有
.java文件提交前由 Git 强制转为 LF；Windows 开发者需设git config --global core.autocrlf input - IDE 设置里关闭 “Transparent native-to-ascii conversion”，避免 .properties 文件被意外转码
IDE 配置不能靠手动导入，要生成可执行的 import 配置
IntelliJ 的 .idea/ 是二进制+路径敏感，Eclipse 的 .settings/ 又常漏关键项（如 formatter、save actions）。靠截图或口头教“点这里导出”无法保证一致性。
- 用
google-java-format+maven-formatter-plugin统一代码风格，而非依赖 IDE formatter - 将 Checkstyle 规则（
checkstyle.xml）和 PMD 规则（pmd-ruleset.xml）提交进仓库，并在pom.xml中绑定到validate生命周期 - 提供
import-eclipse-settings.sh和import-intellij-codestyles.jar（用 IntelliJ SDK 打包的 CLI 工具），让 IDE 配置变成一条命令可恢复
真正难的不是列出这些配置项，而是让它们在新成员 git clone 后五分钟内就进入“开箱即编译”状态——这意味着所有路径、权限、环境变量都要提前验证过，且不能有任何一步依赖个人经验或点击操作。
