核心概念：为什么要设置环境变量？

在设置之前,我们先理解一下为什么需要它。

1. JDK (Java Development Kit)：这是 Java 的开发工具包，包含了编译器（javac.exe）、运行时环境（java.exe）、库文件等。
2. Path 环境变量：操作系统的“命令搜索路径”，当你在命令行（如 CMD 或 PowerShell）中输入一个命令（如 java）并按下回车时，系统会按照 Path 变量中列出的目录顺序，依次去查找是否存在一个可执行文件与该命令同名。

设置 Path 的目的：为了让操作系统的命令行工具在任何位置都能找到并执行 java.exe 和 javac.exe，如果没有设置，你只能在 JDK 的 bin 目录下才能使用这些命令，非常不便。

第一步：安装 JDK

在配置环境变量之前,你必须已经安装了 JDK，如果没有，请先完成安装。

1. 下载 JDK：访问 Oracle 官方网站或 OpenJDK 官网下载适合你操作系统的 JDK 版本。
   • Oracle JDK: https://www.oracle.com/java/technologies/downloads/
   • OpenJDK (推荐，免费开源): https://jdk.java.net/ 或各大云厂商（如 Amazon, Microsoft, Alibaba）提供的 OpenJDK 版本。
2. 安装 JDK：按照安装向导进行安装。强烈建议使用默认安装路径，
   • Windows: C:\Program Files\Java\jdk-17
   • macOS: /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
   • Linux: /usr/lib/jvm/java-17-openjdk-amd64

第二步：配置环境变量

下面我们分操作系统详细说明配置步骤。

Windows 系统 (以 Windows 11 为例)

Windows 环境变量分为“用户变量”和“系统变量”。推荐设置“系统变量”，这样所有用户账户都可以使用。

1. 打开环境变量设置

   • 按 Win + S 键，搜索“编辑系统环境变量”，然后打开它。
   • 或者,右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。

2. 配置 JAVA_HOME (最佳实践) JAVA_HOME 是一个指向 JDK 安装根目录的变量，很多 Java 应用（如 Tomcat、IntelliJ IDEA）依赖它来找到 JDK。强烈建议设置。

   • 在“系统变量”区域，点击“新建”。
   • 变量名: JAVA_HOME
   • 变量值: 填写你的 JDK 安装根目录路径。C:\Program Files\Java\jdk-17
   • 点击“确定”。

3. 配置 Path 变量

   • 在“系统变量”区域，找到并选中 Path 变量，然后点击“编辑”。
   • 在弹出的窗口中,点击“新建”。
   • 添加 %JAVA_HOME%\bin。
     • 注意：这里的 %JAVA_HOME% 是一个引用，它会自动替换为你刚才设置的 JAVA_HOME 变量的值，这样做的好处是，如果未来你升级 JDK，只需修改 JAVA_HOME 的值即可，无需再修改 Path。
   • 重要：确保 %JAVA_HOME%\bin 这一行位于列表的顶部或靠前的位置，这样可以优先使用你指定的 JDK 版本，避免与其他版本的 Java 冲突。
   • 如果系统已经存在其他 JDK 的路径（如旧的 C:\Program Files\Java\jdk-1.8.0\bin），你可以选择将其删除或注释掉，以保持环境整洁。
   • 点击“确定”保存所有修改。

4. 验证配置

   • 完全关闭并重新打开 你的命令行工具（CMD、PowerShell 或 Windows Terminal），因为环境变量的更改只在新的进程中生效。
   • 输入以下命令进行验证：

     java -version

     如果显示你安装的 JDK 版本信息，说明 java 命令已生效。

     javac -version

     如果显示编译器版本信息,说明 javac 命令已生效。

     echo %JAVA_HOME%

     如果输出你设置的 JDK 路径，说明 JAVA_HOME 变量已生效。

macOS / Linux 系统

在 macOS 和 Linux 中，我们通常使用终端来配置，这些修改会写入到用户的 shell 配置文件中（如 .bash_profile, .zshrc），macOS 默认使用 Zsh shell，所以我们以 .zshrc 为例。

1. 打开终端

   • macOS: 应用程序 -> 实用工具 -> 终端。
   • Linux: 通常在应用程序菜单中可以找到。

2. 找到 JDK 安装路径

   • 在终端中输入以下命令,通常会列出已安装的 JDK：

     /usr/libexec/java_home -V

   • 你会看到类似下面的输出,从中找到你想要使用的 JDK 的路径。

     Matching Java Virtual Machines (2):
         17.0.8 (x86_64) "Oracle Corporation" - "Java SE 17.0.8" /Library/Java/JavaVirtualMachines/jdk-17.0.8.jdk/Contents/Home
         1.8.0_322 (x86_64) "Oracle Corporation" - "Java SE 1.8.0_322" /Library/Java/JavaVirtualMachines/jdk1.8.0_322.jdk/Contents/Home

     假设我们想使用 JDK 17，那么路径就是 /Library/Java/JavaVirtualMachines/jdk-17.0.8.jdk/Contents/Home。

3. 编辑配置文件

   • 使用 vim 或 nano 等编辑器打开 .zshrc 文件（如果使用 Bash，则打开 .bash_profile 或 .bashrc）。

     vim ~/.zshrc

4. 添加环境变量

   • 在文件末尾添加以下内容（请将路径替换为你自己的 JDK 路径）：

     # Set JDK 17 as default
     export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.0.8.jdk/Contents/Home
     # Add JDK bin to PATH
     export PATH="$JAVA_HOME/bin:$PATH"

   • 解释:

     • export JAVA_HOME=...：设置 JAVA_HOME 变量。
     • export PATH="$JAVA_HOME/bin:$PATH"：将 JAVA_HOME/bin 目录添加到 PATH 的最前面。$PATH 是原有的 PATH 值，这样能确保优先使用我们设置的 JDK。

5. 保存并退出

   • 如果使用 vim，按 Esc，然后输入 wq 并回车。
   • 如果使用 nano，按 Ctrl + X，然后按 Y，再按回车。

6. 使配置生效

   • 在终端中运行以下命令,让当前的 shell 会话加载新的配置：

     source ~/.zshrc

   • 或者,你可以直接关闭终端然后重新打开一个新的。

7. 验证配置

   • 输入以下命令进行验证：

     java -version
     javac -version
     echo $JAVA_HOME

     如果都输出正确信息,说明配置成功。

常见问题与排查

问题1：'java' 不是内部或外部命令...

• 原因：Path 变量没有配置正确，或者系统没有找到 JDK 的 bin 目录。
• 解决：
  1. 检查 JAVA_HOME 和 Path 的拼写是否完全正确，特别是路径中的空格和大小写。
  2. 确保你添加的是 %JAVA_HOME%\bin (Windows) 或 $JAVA_HOME/bin (macOS/Linux)。
  3. 务必关闭并重新打开命令行窗口。
  4. 检查 JDK 是否真的安装在指定的路径下。

问题2：java -version 显示的版本不是我安装的版本

• 原因：Path 变量中，旧的 JDK 路径在你新添加的路径之前，导致系统优先找到了旧版本的 Java。
• 解决：编辑 Path 变量，将 %JAVA_HOME%\bin 或 $JAVA_HOME/bin 这一行拖动到列表的最顶部。

问题3：在 macOS/Linux 中，source 后命令依然无效

• 原因：你可能编辑错了文件（.bashrc 而你用的是 Zsh），或者文件路径不正确。
• 解决：再次确认你编辑的是 ~/.zshrc (Zsh) 或 ~/.bash_profile (Bash)，并确保 export 语句格式正确。

遵循以上步骤,你就能成功配置好 Java 的开发环境，祝你编程愉快！