怎么么更换jdk版本

生活妙招 changlong 2025-10-08 15:02 2

为什么要更换 JDK 版本？

在开发 Java 应用时，我们经常会遇到需要切换不同版本 JDK 的情况，比如项目依赖了某个特定版本的 JDK 功能（如 Java 8 的 Lambda 表达式、Java 11 的模块化系统），或者企业环境要求统一使用某版本以保证兼容性和安全性，新版本 JDK 常常带来性能优化、安全补丁和语法改进，合理升级能提升代码质量与运行效率。

但如何正确更换 JDK？这不仅是命令行操作，还涉及环境变量配置、IDE 设置以及项目构建工具（如 Maven、Gradle）的适配，本文将详细介绍从基础到进阶的更换步骤，帮助你无痛完成 JDK 升级。

检查当前 JDK 状态

首先确认当前使用的 JDK 版本：

java -version
javac -version

输出示例：

openjdk version "17.0.6" 2022-01-18
OpenJDK Runtime Environment (build 17.0.6+9-Debian-1)
OpenJDK 64-Bit Server VM (build 17.0.6+9-Debian-1)

如果显示的是旧版本（如 JDK 8 或 11），说明你需要更换，此时建议记录下当前版本号，以便后续对比或回退。

下载并安装新版本 JDK

访问 Oracle 官网或 AdoptOpenJDK（推荐开源社区支持）下载目标版本的 JDK 包，

JDK 版本	推荐来源	下载地址
JDK 8	AdoptOpenJDK	https://adoptium.net/temurin8/
JDK 11	Eclipse Temurin	https://adoptium.net/temurin11/
JDK 17	Eclipse Temurin	https://adoptium.net/temurin17/

下载后解压到指定目录（如 /usr/lib/jdk-17），确保权限正确：

sudo tar -xzf jdk-17_linux-x64_bin.tar.gz -C /usr/lib/

配置环境变量（Linux/macOS）

编辑 ~/.bashrc 或 /etc/environment 文件，添加如下内容：

export JAVA_HOME=/usr/lib/jdk-17
export PATH=$PATH:$JAVA_HOME/bin

保存后执行：

source ~/.bashrc

验证是否生效：

echo $JAVA_HOME
java -version

若输出为新版本,则配置成功。

Windows 系统设置方法

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。

新建变量 JAVA_HOME，值设为新 JDK 路径（如 C:\Program Files\Java\jdk-17）。

在“系统变量”中找到 Path，添加 %JAVA_HOME%\bin。

重启命令提示符后测试：

java -version

IDE 配置（IntelliJ IDEA / Eclipse）

IntelliJ IDEA：
进入 File → Project Structure → SDKs，点击 + 号添加新 JDK 路径，选择后，同步项目结构即可。

Eclipse：
Window → Preferences → Java → Installed JREs → Add → Standard VM，填写 JDK 安装路径，再设置项目 Build Path 使用该版本。

注意：部分插件或框架（如 Spring Boot）可能对 JDK 有最低要求，务必检查文档！

构建工具适配（Maven / Gradle）

Maven：在 pom.xml 中显式声明：

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

Gradle：在 build.gradle 中：

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

这样可避免因本地 JDK 不匹配导致编译失败。

常见问题排查

问题现象	可能原因	解决方案
java -version 显示旧版本	环境变量未刷新	重新加载 shell 或重启终端
IDE 报错找不到 JDK	项目未更新 SDK 设置	在 IDE 中手动指定新 JDK 路径
Maven 编译失败	pom.xml 中版本不一致	修改 source/target 版本并清理缓存
服务启动报错	系统默认 JDK 仍为旧版本	检查 systemctl 或 service 启动脚本