JDK17 安装教程（适用于 Windows / macOS / Linux）

本文为面向初学者的详尽安装指南，包含下载渠道、Windows/macOS/Linux 的安装步骤、环境变量配置、IDE（IntelliJ IDEA）配置及常见问题排查，适合直接复制到 CSDN 发布。

目录

  1. 为什么选择 JDK17（简短说明）
  2. 推荐发行版与下载地址（可选：Oracle / Temurin / Corretto）
  3. Windows 安装（详细步骤 + 环境变量）
  4. macOS 安装（Homebrew / 手动）
  5. Linux 安装（APT / Yum / 手动）
  6. IntelliJ IDEA 中配置 JDK（项目与全局）
  7. 验证安装与常见命令
  8. 常见问题与解决方案（Maven、多个 JDK 冲突等）
  9. 卸载旧版 JDK 的建议
  10. 发布到 CSDN 的小提示与版权声明

1. 为什么选择 JDK17

  • JDK17 是长期支持版（LTS），许多框架（如 Spring Boot 3.x）要求最低 JDK17。
  • 稳定且长期获得安全更新，适合生产与学习使用。

2. 推荐发行版与下载地址

常用且推荐的 JDK 发行版：

  • Temurin (Eclipse Adoptium)（推荐）: https://adoptium.net/ (免费、稳定、广泛使用)
  • Amazon Corretto: https://aws.amazon.com/corretto/
  • Oracle JDK: https://www.oracle.com/java/technologies/downloads/ （部分版本需要 Oracle 账号）
  • Microsoft Build of OpenJDK / Azul Zulu 等也可选择。

推荐选择 Temurin 17，安装方便且兼容性好。以下示例以 Temurin 为主，Oracle/Corretto 操作类似。

3. Windows 安装（最详细）

3.1 下载（以 Temurin 为例）

  1. 打开 https://adoptium.net/temurin/releases/?version=17
  2. 选择 Windows、x64、版本 17，点击 msi 或 installer 下载（.msi/.exe）。

3.2 安装步骤（图形界面）

  1. 双击下载的安装文件（.msi 或 .exe）。
  2. 选择安装路径（推荐）：C:\Program Files\Java\jdk-17.x.x。
  3. 勾选（如果有）“Set JAVA_HOME variable” 或“Add to PATH”（若安装程序提供）。
  4. 点击安装并完成。

3.3 手动配置环境变量（如果安装程序未自动设置）

强烈建议通过 系统环境变量 界面配置，按步骤操作：

  1. 打开「系统属性」：Win + R → 输入 sysdm.cpl → 回车 → 选择“高级” → 点击“环境变量”。
  2. 在“系统变量”中点击“新建”，添加：
    • 变量名：JAVA_HOME
    • 变量值：C:\Program Files\Java\jdk-17.0.x（用你实际安装的目录替换）
  3. 选择系统变量 Path → 点击“编辑” → 新建一项：%JAVA_HOME%\bin。
  4. 点击确定保存，关闭并重新打开命令提示符以使变量生效。

也可以使用命令行临时/用户级设置（不推荐覆盖 PATH）：

# 设置用户级 JAVA_HOME（立即生效需要重启新的终端）
setx JAVA_HOME "C:\Program Files\Java\jdk-17.0.8"

# 验证（新终端）
echo %JAVA_HOME%
java -version
javac -version

3.4 验证（Windows 命令提示符）

where java
where javac
java -version
javac -version
echo %JAVA_HOME%

典型输出示例：

java version "17.0.8" 2023-07-18 LTS
javac 17.0.8
C:\Program Files\Java\jdk-17.0.8

4. macOS 安装

方法 A：Homebrew（推荐）

brew update
brew install --cask temurin17   # 或 adoptopenjdk/openjdk/adoptopenjdk17 取决于 repo
# 验证
java -version

若需要设置 JAVA_HOME（Zsh/Bash）：

# zsh (macOS 默认)
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
source ~/.zshrc
java -version
echo $JAVA_HOME

方法 B：下载官方 dmg/installer

  1. 到 Adoptium/Oracle 下载 macOS 安装包，双击安装。
  2. 同样使用 /usr/libexec/java_home -v 17 来定位并在 shell 配置文件中设置 JAVA_HOME。

5. Linux 安装

Debian / Ubuntu（使用 Temurin apt 仓库或 openjdk）

# 方式1: 安装 openjdk（Ubuntu 官方仓库）
sudo apt update
sudo apt install openjdk-17-jdk

# 方式2: 使用 Adoptium（Temurin）APT 仓库（更稳定的发行版包）
# 按照 Adoptium 官方文档添加仓库并安装 temurin-17-jdk

验证：

java -version
javac -version
echo $JAVA_HOME   # 若未设置，手动设置见下

手动设置（示例）：

# 添加到 ~/.bashrc 或 ~/.profile
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
# 然后 source ~/.bashrc

RHEL / CentOS（yum）

sudo yum install java-17-openjdk-devel

6. IntelliJ IDEA 中配置 JDK（详细）

  1. 打开 IntelliJ IDEA → File → Project Structure（或 Ctrl+Alt+Shift+S）。
  2. 在左侧选择 SDKs → 点击 + → Add JDK → 选择 JDK 安装目录（例如 C:\Program Files\Java\jdk-17.0.8）。
  3. 添加后，去 Project → Project SDK 选择你刚添加的 JDK。
  4. 若使用 Maven：确保 Settings → Build Tools → Maven 使用的 JDK（Runner/Toolchains）是正确的。

如果 IDEA 在 .jdks 下有自动管理的 JDK，也可以删掉 .jdks，但要保证全局系统 JDK 正确（见下“卸载”）。

7. 验证安装与常见命令（汇总）

  • 查看 java 可执行路径：where java（Windows）或 which java（mac/linux）
  • 检查版本：java -version，javac -version
  • 检查环境变量：echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（mac/linux）

8. 常见问题与解决方法

问：java -version 是 17，但 echo %JAVA_HOME% 指向旧版本？

  • 说明系统有多个 JDK，java 命令可能来自 PATH 中的某个位置（例如 C:\Program Files\Common Files\Oracle\Java\javapath 指向的快捷方式）。需要把 JAVA_HOME 指向你想用的 JDK，并确保 PATH 中 JAVA_HOME\bin 在优先位置。

问：Maven 编译报 错误: 不支持发行版本 17 或 unsupported release: 17

  • 原因：Maven 使用的 JDK 与项目设置不一致，或 maven-compiler-plugin 版本过旧。解决：
    • 确保 JAVA_HOME 指向 JDK17，且 java -version 返回 17。
    • 在 pom.xml 中指定 Java 版本：
      <properties>
  <java.version>17</java.version>
</properties>
    • 如果需要，指定 maven-compiler-plugin 支持的版本（3.8.1+ 或更新），并设置 <source>17</source> <target>17</target>。

问：如何卸载旧版本 JDK？

  • Windows：设置 → 应用 → 应用和功能 或 控制面板 → 程序和功能 中卸载对应 JDK。然后删除 C:\Program Files\Java\ 中的残留文件夹，并清理环境变量。
  • macOS / Linux：用包管理器卸载或手动删除安装目录。

9. 卸载旧版 JDK 的建议步骤（Windows）

  1. Win + R → 输入 appwiz.cpl → 回车。
  2. 在程序列表中找到 Java / JDK 条目，点击卸载（逐个卸载你不需要的版本）。
  3. 检查并删除残留目录：C:\Program Files\Java\（删除旧版本文件夹）。
  4. 打开环境变量，删除对旧 JDK 的 JAVA_HOME 或 PATH 引用。
  5. 重新设置 JAVA_HOME 指向 JDK17 并验证。

10. CSDN 发布小提示

  • 标题建议：《JDK17 安装详解（Windows/macOS/Linux）——一步一步教你配置环境变量与 IDEA》。
  • 可配图：安装向导截图、环境变量界面截图、java -version 输出截图。
  • 在 CSDN 发布时可使用一级标题 #、二级标题 ## 保持层次清晰；插入代码块用三反引号。
  • 在文末可以附上快速命令汇总表，方便读者复制使用。

附：快速命令汇总（可复制）

Windows（手动设置 JAVA_HOME）

setx JAVA_HOME "C:\Program Files\Java\jdk-17.0.8"
# 重新打开 cmd 后验证
echo %JAVA_HOME%
java -version
javac -version

Linux（例：Ubuntu）

sudo apt update
sudo apt install openjdk-17-jdk
# 或使用 temurin 仓库安装 temurin-17-jdk
echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64' >> ~/.bashrc
source ~/.bashrc
java -version

macOS（Homebrew）

brew install --cask temurin17
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
source ~/.zshrc
java -version

如果你愿意，我可以把本文生成为 Markdown 文件（便于直接复制到 CSDN 编辑器），或导出为 PDF。现在我已经把 Markdown 文档生成好了（文件名见下）。

# java # windows
Logo
乐奇 Rokid 开放社区

更多推荐

哪个家电企业综合技术全球领先？看TCL白电

挑冰箱时，这正是判断一个品牌的冰箱值不值得买的地方。在AI应用之外，面向AI时代，又将AI技术落到产品深处，打造AR智能眼镜、家庭「 陪 · 育」机器人、智能电视、AI空调、AI洗衣机、AI冰箱等多产品线，在智能制造和智能生活上深度布局。回头看，TCL家电的技术不在于某一句宣传语，而在于一台电视的显示技术、一台冰箱的冷凝器、一台空调的变频控制器、一台洗衣机的传感器等细节里。一台家电好不好，往往不由

avatar 乐奇 Rokid 开放社区

在 Rokid AI Glasses 上做背单词应用：AIUI拍照听写的实现

分享在 Rokid AI Glasses 上用 AIUI 开发背单词应用的实践：从镜腿单击拍照、图片编码和多模态识别，到切题时的异步任务处理、语音调度与学习进度保存，结合关键代码和界面动图说明实现过程。

avatar 乐奇 Rokid 开放社区

6.9 元还是 13.5 元？在 Rokid 眼镜上用 AIUI 算清单位价

500 毫升，6.9 元。1.25 升，13.5 元。把两项都换成一升，价格分别是 13.80 元和 10.80 元。总价更高的那瓶，单位价格反而更低。不过，这个结论有一个前提：规格和价格都得读对。假如第二瓶实际只有 750 毫升，13.5 元这个总价没有变，比较结果就会转向另一边。我用这两组数字做了一个 AIUI 小项目，叫“比一比”。它接收两项报价，把每份规格、包装件数和整组总价放到两张卡片上

avatar 乐奇 Rokid 开放社区