本手册面向Java新手、转语言开发者及校内实训学生,用于快速运行Hello World、编译Maven项目、接入IntelliJ IDEA等场景;基于Windows/macOS/Linux通用逻辑,差异处单独标注。1. JDK安装:下载OpenJDK 17 LTS(https://adoptium.net/),选JDK而非JRE;安装后执行java -version和javac -version双验证。2. 环境变量:设JAVA_HOME为JDK根目录(如C:\Program Files\Eclipse Adoptium\jdk-17.0.1+12),PATH中添加%JAVA_HOME%\bin(Win)或$JAVA_HOME/bin(macOS/Linux);重启终端或执行source ~/.zshrc生效。3. Maven选配:解压apache-maven-3.9.x到无空格路径,设MAVEN_HOME,PATH追加%MAVEN_HOME%\bin;运行mvn -v确认含Java与Maven版本。4. IDE衔接:IntelliJ新建Java项目时指定Project SDK;Eclipse在Preferences→Installed JREs中添加并设默认;VS Code装Java扩展包后状态栏点击版本号切换。排错附录:“'javac'不是命令”→检查PATH含%JAVA_HOME%\bin

编写一份实用的 Java 开发环境配置手册,核心是让读者能快速、准确、可复现地完成本地开发环境搭建。它不是技术文档汇编,而是面向真实操作场景的“步骤型指南”。
明确目标读者和使用场景
手册开头需说明适用对象(如:Java 新手、转语言开发者、校内实训学生)和典型用途(如:运行 Hello World、编译 Maven 项目、接入 IntelliJ IDEA)。避免默认读者已知 JDK 路径或环境变量概念。可加一句提示:“本手册基于 Windows/macOS/Linux 通用逻辑,关键差异处单独标注”。
分步呈现核心组件安装与验证
按实际依赖顺序组织,每步包含 做什么、为什么做、怎么确认成功:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
-
JDK 安装:推荐 LTS 版本(如 JDK 17 或 21),给出官网直达链接;强调下载 Development Kit(非 JRE);安装后必须执行
java -version和javac -version双验证。 -
环境变量配置:清晰说明
JAVA_HOME指向 JDK 根目录(非 bin 子目录),PATH中追加%JAVA_HOME%\bin(Windows)或$JAVA_HOME/bin(macOS/Linux);提醒重启终端或执行source ~/.zshrc生效。 -
构建工具选配:Maven 或 Gradle 二选一即可。提供解压即用方式(免安装),重点教如何验证
mvn -v输出含 Java 版本和 Maven 版本;补充常见报错如 “JAVA_HOME not found” 的排查路径。
集成开发环境(IDE)衔接要点
不堆砌截图,聚焦配置联动:
- IntelliJ IDEA:新建项目时选择 “New Project → Java”,在右侧指定 Project SDK 为已安装的 JDK;提示若未识别,点击 “Add JDK…” 手动定位
jdk-xx.x.x目录。 - Eclipse:进入 Preferences → Java → Installed JREs,点击 “Add… → Standard VM”,浏览至 JDK 安装路径;确保勾选并设为默认。
- VS Code:安装 Extension Pack for Java,打开含
.java文件的文件夹后,状态栏点击 Java 版本号可切换 SDK。
加入轻量级排错附录
用问题驱动式罗列高频卡点,每条一句话定位 + 一句话解决:
-
“'javac' 不是内部或外部命令” → 检查 PATH 是否包含
%JAVA_HOME%\bin,且 JAVA_HOME 路径无中文、空格、符号。 -
“Maven 编译提示 Java 版本不匹配” → 查看项目
pom.xml中maven-compiler-plugin的source和target,与本地 JDK 版本对齐。 - “IDE 显示类找不到,但命令行可编译” → 刷新 Maven 项目(IDEA 右键项目 → Reload;Eclipse 右键 → Maven → Update Project)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










