推荐用 apt 安装 OpenJDK（如 openjdk-17-jdk），系统自动配置 update-alternatives 和 JAVA_HOME；避免手动解压 tar.gz，否则易引发版本不一致、IDE 识别失败及构建错误。
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 可能用错编译器。
立即学习“Java免费学习笔记（深入）”；
- 查看当前配置：
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 上。
