在 Ubuntu 上使用 VSCode 进行 Java 开发
一 环境准备
- 安装 JDK 11 或更高版本(推荐 OpenJDK 11):
- 更新索引并安装:
sudo apt update && sudo apt install openjdk-11-jdk
- 验证版本:
java -version
- 安装 Visual Studio Code(任选其一):
- Snap 安装:
sudo snap install --classic code
- 或到官网下载 .deb 包安装(Ubuntu 软件中心亦可)。
二 安装与配置 Java 扩展
- 打开 VSCode,进入扩展视图(快捷键 Ctrl+Shift+X),搜索并安装 Java Extension Pack(包含 Language Support for Java、Debugger for Java、Maven for Java 等)。
- 可选:安装 Code Runner 以便快速运行单个文件。
- 指定 JDK 路径(当系统存在多版本 JDK 或 VS Code 未自动识别时):
- 打开设置(快捷键 Ctrl+,),搜索 java.home,设置为 JDK 安装目录,例如:/usr/lib/jvm/java-11-openjdk-amd64。
- 或打开命令面板(Ctrl+Shift+P)输入 Preferences: Open Settings (JSON),添加:
"java.home": "/usr/lib/jvm/java-11-openjdk-amd64"。
三 创建项目与运行调试
- 新建项目并打开:
- 终端:
mkdir MyJavaApp && cd MyJavaApp && code .
- 新建源文件:例如 Main.java
- 示例代码:
public class Main { public static void main(String[] args) { System.out.println("Hello, World!"); } }
- 运行与调试:
- 直接运行:在编辑器右上角点击 Run | Debug,或按 F5 启动调试。
- 快速运行单文件(需安装 Code Runner):在编辑器右上角点击 Run Code,或右键选择 Run Code。
- 常用操作提示:
- 代码跳转:在符号上 Ctrl+点击 即可跳转到定义。
- 项目管理:使用 Maven 或 Gradle 扩展可创建与管理多模块项目。
四 多版本 JDK 切换与常见问题
- 多版本 JDK 切换(示例:项目使用 JDK 8,工具运行在 JDK 11+):
- 在 VSCode 设置 JSON 中配置运行时的 JDK 映射,并将需要的版本设为默认:
"java.configuration.runtimes": [ { "name": "JavaSE-1.8", "path": "/usr/lib/jvm/java-8-openjdk-amd64", "default": true }, { "name": "JavaSE-11", "path": "/usr/lib/jvm/java-11-openjdk-amd64" } ]
- 说明:VS Code 的 Java 扩展运行环境需 JDK 11 及以上,但可编译运行 JDK 8 等低版本代码(按项目配置)。
- 常见问题排查:
- 无法识别 JDK:检查 java -version 输出,确认已安装;在 VSCode 设置 java.home 指向正确的 JDK 目录。
- 扩展未生效:重启 VSCode,确保 Java Extension Pack 已启用。
- 运行报错:确认源文件位于 src 目录或已正确配置 classpath;使用调试模式可获得更详细错误信息。