VS Code 通过配置 JDK、插件和构建工具可胜任 Java 开发:需安装 JDK 17/21、VS Code 及 Extension Pack for Java 等插件,用向导创建项目,配置 UTF-8 编码、指定 JDK 路径,并支持一键调试与测试。

VS Code 本身不是 Java IDE,但通过合理配置插件和工具链,完全可以胜任日常 Java 开发——轻量、启动快、插件生态活跃,适合学习、脚手架项目或微服务模块开发。
安装必要组件:JDK + VS Code + 核心插件
这是最基础的三件套,缺一不可:
-
JDK(建议 JDK 17 或 JDK 21):从 Eclipse Temurin 或 Oracle 官网下载并安装;安装后在终端运行
java -version和javac -version验证,确保JAVA_HOME环境变量已正确设置(Windows 建议用系统变量,macOS/Linux 在~/.zshrc或~/.bash_profile中配置)。 - VS Code 最新版:官网下载安装即可,无需额外配置。
-
必需插件(在 Extensions 商店搜索安装):
- Extension Pack for Java(微软官方打包插件,含 Language Support for Java、Debugger for Java、Project Manager for Java 等核心功能)
- Test Runner for Java(支持 JUnit 5 / TestNG 运行测试)
- Gradle for Java(如使用 Gradle 构建,推荐安装;Maven 用户可选 Maven for Java)
初始化 Java 项目:推荐用 VS Code 向导或命令行生成
不依赖外部 IDE,VS Code 可直接创建结构规范的 Java 项目:
- 打开空文件夹 → 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)→ 输入Java: Create Java Project→ 选择构建工具(Maven/Gradle)→ 输入 GroupId/ArtifactId → 自动生成标准目录(src/main/java、src/test/java等)。 - 若已有 Maven/Gradle 项目,直接用 VS Code 打开根目录即可,插件会自动识别
pom.xml或build.gradle并加载依赖、源码路径和测试类。 - 注意:首次打开时右下角可能弹出“Load project”,务必点击确认,否则类无法解析、无代码补全。
关键配置项:让开发体验更顺滑
部分默认配置需手动调整,否则容易遇到编译失败、乱码或断点不生效等问题:
立即学习“Java免费学习笔记(深入)”;
-
编码统一为 UTF-8:在 VS Code 设置中搜索
files.encoding,设为utf8;同时在settings.json中添加:"java.configuration.updateBuildConfiguration": "interactive"(避免自动覆盖 Maven/Gradle 配置) -
指定 JDK 版本:按
Ctrl+Shift+P→ 输入Java: Configure Java Runtime→ 在 Java Runtime Configuration 页面中,为 Default JRE 和 Project JRE 显式选择你安装的 JDK 路径(尤其当机器上有多个 JDK 时)。 -
启用 Java 语言服务器增强功能:在
settings.json中加入:"java.symbols.includeBinaries": true(索引 jar 包内符号,提升跳转准确性)"java.configuration.runtimes": [ { "name": "JavaSE-17", "path": "/path/to/jdk-17" } ](明确声明支持的运行时)
调试与运行:和 IntelliJ 类似,但操作更轻量
无需配置复杂 Run Configuration,VS Code 支持一键运行和断点调试:
- 在 Java 文件中,点击左侧编辑器边栏设置断点(红点),按
F5启动调试;首次会自动生成.vscode/launch.json,其中mainClass会自动识别含public static void main(String[] args)的类。 - 右键点击 Java 类 → 选择
Run Java或Debug Java,适用于快速验证单个类。 - 测试类支持同理:打开
xxxTest.java→ 点击上方出现的Run Test或Debug Test按钮(由 Test Runner 插件提供)。 - 如果调试时提示 “Source not found”,检查
launch.json中projectName是否匹配当前项目名,或尝试重启 Java 语言服务器(Ctrl+Shift+P→Java: Restart Language Server)。










