Ubuntu用户应优先使用apt安装OpenJDK(如openjdk-21-jdk),避免手动解压tar.gz;装完需配置JAVA_HOME并重载shell配置,IDE和CI脚本需单独处理环境变量或直接调用/usr/bin/java。

Ubuntu直接用apt装OpenJDK最稳
Ubuntu官方源里的openjdk-17-jdk或openjdk-21-jdk是预编译好、经过测试的包,不用自己下载tar.gz、解压、配JAVA_HOME、改PATH——那些操作在Ubuntu上纯属绕路,还容易出错。
常见错误现象:java -version报command not found,或者javac根本不存在,八成是装了jre没装jdk,或者装了旧版(比如default-jdk指向的是OpenJDK 11,但项目要17+)。
- 查当前可用版本:运行
apt list -a openjdk-*-jdk,看哪些带installed标记 - 装明确版本(推荐):
sudo apt install openjdk-21-jdk(21是LTS,兼容性好;17也行;别用8或11除非真有遗留需求) - 装完立刻验证:
java -version和javac -version必须输出一致的版本号 - Ubuntu不自动设
JAVA_HOME,需要手动加到~/.bashrc或/etc/environment里:export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64(路径用readlink -f $(which java)往上推两级可确认)
别从官网下tar.gz手动配环境变量
OpenJDK官网提供的Linux .tar.gz包,是给没包管理器的系统(比如某些CentOS精简版、Docker基础镜像)准备的。Ubuntu有apt,硬上tar.gz只会带来三个实际问题:路径不统一、更新要手动、多版本切换麻烦。
使用场景:只有当你需要一个完全隔离、不干扰系统Java的临时环境(比如CI脚本里跑特定版本),才考虑curl + tar + export。日常开发、部署、学习,没必要。
立即学习“Java免费学习笔记(深入)”;
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
- 手动解压后
JAVA_HOME容易写错路径,比如漏掉/jre或写成jdk-21.0.1这种带补丁号的目录名(apt装的路径固定,无补丁号) -
update-alternatives配置混乱后,java -version和javac -version可能指向不同JDK - apt升级系统时,手动装的JDK不会被更新,安全补丁得自己盯
检查JAVA_HOME和PATH是否生效
很多人装完以为完事了,结果IDE(如IntelliJ)或构建工具(如Maven)还是报找不到javac,问题往往出在Shell会话没重载配置,或IDE没读取用户级环境变量。
常见错误现象:echo $JAVA_HOME有输出,但mvn compile仍提示“Unsupported class file major version”——说明Maven实际用的不是你设的那个JDK。
- 新开终端后先运行
source ~/.bashrc(或source ~/.zshrc,看你用什么shell) - 确认
which java和which javac指向/usr/bin/java这类符号链接,而不是绝对路径(apt装的会通过update-alternatives管理) - IDE需要重启,或在设置里显式指定
JDK location为/usr/lib/jvm/java-21-openjdk-amd64 - CI/CD脚本里别依赖
$JAVA_HOME,直接用/usr/bin/java更可靠
多版本共存时用update-alternatives切JDK
如果确实要同时装17和21(比如老项目用17,新项目用21),Ubuntu的update-alternatives比手动改PATH靠谱得多,它能统一管理java、javac、jar等所有命令的软链接。
参数差异:sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-17-openjdk-amd64/bin/java 1里的数字是优先级,数值越大默认选中;--config java会弹出交互菜单让你选。
- 装多个JDK后,务必对每个命令都注册:
java、javac、jar、javadoc,否则切版本时只有java动了,javac还是旧的 - 执行
sudo update-alternatives --config java后,终端要新开一个才能看到效果 - 不要用
export JAVA_HOME=...配合update-alternatives混用——前者只影响当前shell,后者影响所有用户调用的命令,逻辑冲突
最容易被忽略的是:IDE和后台服务(比如systemd启动的Spring Boot应用)不会自动继承你终端里export的环境变量,它们要么靠系统级/etc/environment,要么靠显式配置。这点不厘清,换十次JDK都没用。

















