Ubuntu配置OpenJDK环境教程

本文深入剖析了在Ubuntu系统中正确配置OpenJDK环境的核心原则与实操要点，强调必须优先使用apt安装官方仓库的openjdk-*-jdk包（如openjdk-17-jdk），而非手动解压tar.gz——此举可自动完成update-alternatives注册、JAVA_HOME设置及权限管理，彻底规避90%由路径错误、版本不一致、IDE识别失败和Maven/Gradle构建异常（如UnsupportedClassVersionError）引发的典型问题；同时详解了多JDK版本安全切换的关键操作（需分别配置java和javac的update-alternatives）、IDE（IntelliJ/VS Code）精准识别JDK的正确路径选择（务必指向/usr/lib/jvm/下的JDK主目录而非jre子目录），并点明最易被忽视却至关重要的细节：java与javac的版本必须严格同步，否则将导致“运行正常但编译失败”的隐蔽陷阱。

Ubuntu 上装 OpenJDK，直接用 apt 装系统包最稳，别自己下 tar.gz 手动配 JAVA_HOME —— 90% 的环境变量问题和权限错误都源于此。

怎么用 apt 装 OpenJDK（推荐 Ubuntu 22.04+）

Ubuntu 官方仓库的 OpenJDK 更新及时、依赖自动处理、卸载干净。手动解压安装容易漏 java 命令软链或触发 update-alternatives 冲突。

• 查可用版本：apt list -a openjdk-*-jdk（常见有 openjdk-17-jdk、openjdk-21-jdk）
• 装 JDK 17（LTS，生产常用）：sudo apt install openjdk-17-jdk
• 验证：java -version 和 javac -version 应输出一致版本
• JAVA_HOME 通常无需手动设 —— Ubuntu 的 openjdk-*-jdk 包会自动注册到 /usr/lib/jvm/，且 java 命令已由 update-alternatives 管理

为什么不要手动解压 tar.gz 配 JAVA_HOME

手动安装看似“可控”，实则绕过系统包管理，后续升级、多版本切换、IDE 识别都会出问题。尤其 JAVA_HOME 指向错误路径或权限不足时，Maven/Gradle 构建常报 UnsupportedClassVersionError 或找不到 tools.jar（其实 JDK 9+ 已移除该 jar）。

• 典型错误现象：mvn compile 报 Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:... Unsupported major.minor version → 实际是 Maven 用了旧版 JRE，而非项目配置问题
• 手动安装后若硬设 JAVA_HOME=/opt/jdk-17.0.1，但没运行 sudo update-alternatives --install ...，会导致终端里 java 和 IDE 里看到的 Java 版本不一致
• Ubuntu 的 openjdk-*-jdk 包默认把 JAVA_HOME 设为 /usr/lib/jvm/java-17-openjdk-amd64（路径含架构名），这个路径才是 update-alternatives 认可的“权威位置”

多版本共存时如何安全切换

用 update-alternatives 切换，不是改 JAVA_HOME 或删软链。系统级命令（java、javac、keytool）必须同步，否则 Gradle wrapper 可能用错编译器。

• 查看当前配置：update-alternatives --list java
• 交互式切换：sudo update-alternatives --config java（会列出所有已注册的 java 实例，含不同 JDK 版本）
• 注意：只运行 --config java 不等于 javac 也切了 —— 必须对 javac 单独执行一次 sudo update-alternatives --config javac
• 验证是否真切换成功：readlink -f $(which java) 和 readlink -f $(which javac) 输出路径应指向同一 JDK 版本子目录

IntelliJ / VS Code 识别不到 JDK 怎么办

IDE 不读系统 JAVA_HOME，而是依赖 update-alternatives 注册的路径或手动指定的 /usr/lib/jvm/... 目录。强行在 IDE 设置里填 $JAVA_HOME 环境变量是无效的。

• IntelliJ：File → Project Structure → SDKs → “+” → “Add JDK” → 选 /usr/lib/jvm/java-17-openjdk-amd64（路径末尾不含 /jre）
• VS Code + Extension Pack for Java：打开命令面板（Ctrl+Shift+P）→ “Java: Configure Java Runtime” → 在 “Java Runtime” 标签下点 “Add Runtime…” → 浏览到 /usr/lib/jvm/java-17-openjdk-amd64
• 别选 /usr/lib/jvm/java-17-openjdk-amd64/jre —— JDK 11+ 已无独立 JRE，选错会导致 “No Java runtime present” 提示
• 如果 IDE 显示 “corrupted JDK”，大概率是权限问题：检查 /usr/lib/jvm/java-17-openjdk-amd64 下 bin/java 是否可执行（ls -l /usr/lib/jvm/java-17-openjdk-amd64/bin/java，应有 x 权限）

最易被忽略的是：javac 和 java 的 update-alternatives 配置必须分别确认，IDE 编译和运行用的是两个不同的入口点。很多人只切了 java，结果项目能跑但编译报错，卡半天才想起 javac 还钉在 JDK 11 上。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~