Ubuntu 20.04系统下VSCode配置JDK环境问题求助

问题根因 #

Ubuntu 系统通过 apt 安装 OpenJDK 时不会自动配置 JAVA_HOME 环境变量，而 VSCode Java 开发插件依赖该变量定位 JDK 安装路径，仅修改 VSCode 侧配置无法解决系统层面缺失的环境变量问题。

修复步骤 #

1. 配置系统级 JAVA_HOME 环境变量 #

• 编辑当前用户的 bash 配置文件，执行命令：
  nano ~/.bashrc
• 在文件末尾添加如下两行配置：

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

• 保存文件退出编辑器后，执行命令使配置即时生效：
  source ~/.bashrc
• 验证配置是否生效：执行 echo $JAVA_HOME，正常应输出 /usr/lib/jvm/java-11-openjdk-amd64

如果使用 zsh 作为默认终端，请将上述配置添加到 ~/.zshrc 文件中，执行 source ~/.zshrc 生效

2. 修正 VSCode Java 插件配置 #

• 打开 VSCode 设置，搜索 java.configuration.runtimes，点击进入 settings.json 编辑页
• 确保配置项内容如下，default 字段设为 true 表示该版本为默认JDK：

"java.configuration.runtimes": [
    {
        "name": "JavaSE-11",
        "path": "/usr/lib/jvm/java-11-openjdk-amd64",
        "default": true
    }
]

• 完全关闭 VSCode 后台进程后重新打开，避免缓存旧配置

3. 验证修复结果 #

• 打开 VSCode 内置终端，执行 echo $JAVA_HOME 确认返回正确路径
• 重新执行 Java 代码编译、运行操作，确认报错消失

内容的提问来源于stack exchange，提问作者André Luiz Myszko