02-安装与环境配置

Java 安装与环境配置

目标：在 macOS、Windows、Linux 上完成 JDK 安装、环境变量配置、构建工具配置与开发环境验证，形成可编译运行的 Java 开发环境。

---

📦 选择 JDK 版本

• 推荐使用 LTS 版本（如 Java 17），兼顾稳定与生态支持。
• 发行版建议：
  • OpenJDK（社区版，免费）
  • Eclipse Temurin（Adoptium，稳定维护）：Eclipse Temurin
  • Oracle JDK（商业授权策略不同）：Oracle JDK

---

🖥️ 平台安装指南

macOS（Homebrew）

1. 安装 OpenJDK：
   • brew install openjdk@17
2. 链接到系统（必要时）：
   • sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk
3. 配置环境变量（zsh 示例，追加到 ~/.zshrc）：
   • export JAVA_HOME=$(/usr/libexec/java_home -v 17)
   • export PATH="$JAVA_HOME/bin:$PATH"
4. 重新加载配置：
   • source ~/.zshrc

验证：

• java -version
• javac -version

Windows（安装包）

1. 下载并安装 JDK：
   • Temurin MSI（推荐）：下载地址
   • 记住安装路径，如：C:\Program Files\Java\jdk-17
2. 配置系统环境变量：
   • 新建 JAVA_HOME：值为 C:\Program Files\Java\jdk-17
   • 编辑 Path：追加 %JAVA_HOME%\bin
3. 打开新的命令行窗口，验证：
   • java -version
   • javac -version

Linux（Ubuntu/Debian）

1. 通过包管理器安装：
   • sudo apt-get update && sudo apt-get install -y openjdk-17-jdk
2. 设置环境变量（示例放入 ~/.bashrc 或 ~/.zshrc）：
   • export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
   • export PATH="$JAVA_HOME/bin:$PATH"
3. 重新加载配置并验证：
   • source ~/.bashrc 或 source ~/.zshrc
   • java -version
   • javac -version

其他发行版：可参考对应包管理器或使用 tar.gz 安装，将目录解压至 /opt/java/jdk-17 并设置 JAVA_HOME 与 PATH。

---

🧭 多版本管理（可选）

• SDKMAN!（跨平台）：SDKMAN!
  • 安装：curl -s "https://get.sdkman.io" | bash
  • 列出可用版本：sdk list java
  • 安装并设置默认：sdk install java 17.0.x-tem && sdk default java 17.0.x-tem
• macOS jenv：通过 brew install jenv 安装，添加不同 JDK 路径后选择版本。

---

🛠️ 构建工具配置

Maven

• 安装：
  • macOS：brew install maven
  • Ubuntu/Debian：sudo apt-get install -y maven
  • Windows：下载压缩包并解压，设置 MAVEN_HOME 指向目录，Path 追加 %MAVEN_HOME%\bin
• 验证：mvn -v

Gradle

• 安装：
  • macOS：brew install gradle
  • Ubuntu/Debian：sudo apt-get install -y gradle（版本可能较旧，可考虑手动或 SDKMAN!）
  • Windows：下载解压，设置 GRADLE_HOME，Path 追加 %GRADLE_HOME%\bin
• 验证：gradle -v

---

🧰 IDE 与编辑器

• IntelliJ IDEA（推荐）：下载
  • 首次启动在 Project Structure → SDKs 添加 JDK 17
  • 为项目选择 Project SDK: 17 与合适的 Language level
• VS Code（轻量）：安装 Java Extension Pack，扩展市场

---

✅ 环境验证与示例

创建 Hello.java：

public class Hello {
  public static void main(String[] args) {
    System.out.println("Hello, Java");
  }
}

编译与运行：

javac Hello.java
java Hello

预期输出：

Hello, Java

---

🧩 常见问题排查

• javac: command not found
  • 未安装 JDK 或 PATH 未包含 $JAVA_HOME/bin；重新安装并正确配置环境变量。
• java -version 显示版本与预期不一致
  • 系统存在多版本 JDK，使用 SDKMAN!/jenv 设定默认版本或调整 PATH 顺序。
• Maven/Gradle 命令不可用
  • 检查是否正确安装并将 bin 目录加入 PATH；Windows 需新开终端使变量生效。

---

📖 参考链接

• OpenJDK（Adoptium Temurin）：https://adoptium.net/
• Oracle JDK 下载：https://www.oracle.com/java/technologies/downloads/
• SDKMAN!：https://sdkman.io/
• Maven：https://maven.apache.org/
• Gradle：https://gradle.org/install/
• IntelliJ IDEA：https://www.jetbrains.com/idea/

---

最后更新：2025

java 服务端语言 安装 环境配置 工具链