新项目应选用Java 17或Java 21（当前最新LTS版本），企业级项目优先推荐Java 17；需从Eclipse Temurin等官方渠道下载，配置JAVA_HOME和PATH确保一致，并通过java/javac -version验证；项目结构遵循Maven标准，IDE、构建工具与运行时JDK版本必须统一，最后用最小项目完成编译-运行-调试闭环验证。
Java 环境搭建和项目结构不是“装完就能用”的一次性操作，而是影响整个开发周期稳定性和协作效率的基础工程。关键在于版本统一、路径清晰、结构规范、工具链可复现。
选对 JDK 版本并验证兼容性
新项目优先选用 Java 17 或 Java 21（当前最新 LTS 版本），它们在语法支持、JVM 性能和第三方框架适配上已非常成熟。企业级项目尤其推荐 Java 17，兼顾长期维护与安全更新支持。
- 从 Eclipse Temurin（Adoptium）、Microsoft Build of OpenJDK 或 Oracle 官方渠道下载，避免非官方打包版
- 安装后务必执行
java -version和javac -version，确认输出一致且无警告 - 检查所用框架（如 Spring Boot 3.x 要求 JDK 17+，Hibernate 6.4 支持 JDK 21）的最低 JDK 要求
环境变量配置要精准可靠
JAVA_HOME 必须指向 JDK 根目录（不是 jre 子目录），PATH 中必须包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Linux/macOS），否则 IDE 或构建工具可能 fallback 到系统自带旧版本 JRE。
- Windows：使用
setx JAVA_HOME "C:\Program Files\Java\jdk-17.0.2"设置系统级变量 - Linux/macOS：在
~/.bashrc或~/.zshrc中添加两行，保存后运行source ~/.zshrc - 验证方式：新开终端，运行
echo $JAVA_HOME和which java，确保路径匹配
项目结构遵循 Maven 标准约定
即使不用 Maven 构建，也建议采用其目录结构——这是 Java 生态的事实标准，能让 IDE 自动识别源码、测试、资源路径，也能避免手动配置出错。
立即学习“Java免费学习笔记（深入）”；
-
src/main/java：放生产代码，包路径需与 package 声明严格一致 -
src/main/resources：放配置文件（application.properties）、SQL 脚本、静态模板等 -
src/test/java：单元测试类，与主代码同包结构，便于访问 package-private 成员 -
src/test/resources：测试专用配置（如 test-application.yml）、mock 数据等
构建工具与 IDE 配置协同统一
IDE 的编译级别、Maven/Gradle 的 source/target 版本、JDK 运行时三者必须一致，否则会出现 “Unsupported class file major version” 或 IDE 提示“Cannot resolve symbol” 等问题。
- IntelliJ IDEA：File → Project Structure → Project → SDK 和 Language level 设为同一版本（如 17）
- Maven pom.xml 中明确声明：
<maven.compiler.source>17</maven.compiler.source>和<maven.compiler.target>17</maven.compiler.target> - 启用 Maven 的阿里云镜像，在
~/.m2/settings.xml中配置 mirror，加速依赖下载
首次验证不跳过编译-运行-调试闭环
环境搭好后，不要只跑 java -version 就算完成。应新建一个最小可运行项目，完整走一遍流程：
- 用命令行创建
src/main/java/App.java，写一个带 main 方法的类 - 执行
mvn clean compile exec:java（需插件）或先mvn package再java -jar target/*.jar - 在 IDE 中打断点调试，确认变量查看、步进、表达式求值功能正常
