在VS Code里写Java,核心不是编辑器本身,而是背后那套语言服务器与构建工具的协同。只要把扩展和JDK路径理顺,日常编译、断点调试和依赖管理都能在一个窗口里完成,不需要切到IDEA或Eclipse。

一、安装必备扩展插件
微软官方维护的Extension Pack for Java是目前最省心的选择。它不是一个单一插件,而是一个扩展包,内部包含了Language Support for Java、Debugger for Java、Java Test Runner、Maven for Java以及Project Manager for Java。一次性安装后,VS Code就具备了语法高亮、智能补全、单元测试和Maven项目导入能力。
如果你只写简单练习代码,可以只装Language Support for Java by Red Hat,它能提供基础的编译提示。但涉及多模块或者需要断点调试时,还是建议直接装扩展包。另外一个实用插件是Spring Boot Extension Pack,做微服务开发时会自动识别配置文件并启动内嵌服务器。
扩展包内含组件: 1. redhat.java 语言服务 2. vscjava.vscode-java-debug 调试器 3. vscjava.vscode-java-test 测试运行 4. vscjava.vscode-maven 构建工具 5. vscjava.vscode-java-dependency 依赖视图
二、配置JDK与运行环境
VS Code本身不自带JDK,必须先在系统里装好JDK 8或以上版本。打开设置界面,搜索java.home,填入JDK根目录,例如Windows下是C:\Program Files\Java\jdk-17。若机器上有多个JDK,可在工作区设置里单独指定,避免全局污染。
配置完成后,新建一个Hello.java,右键选择“Run Java”即可。编辑器会调用后台语言服务器编译并执行,结果打印在OUTPUT面板。对于单文件,这种方式最快;但对于有包结构的项目,需要确保目录与package声明一致,否则会报找不到类的错误。
// Hello.java
public class Hello {
public static void main(String[] args) {
System.out.println("VS Code Java OK");
}
}
三、调试配置与launch.json
当程序需要传参或附加环境变量时,就要写launch.json。在运行视图点“创建launch.json”,选Java环境,会自动生成模板。其中mainClass字段填完整类名,args是字符串数组,console建议选internalConsole方便看输出。
如果项目由Maven管理,插件会自动生成调试入口,不需要手动维护。但遇到多主类模块,可以在configurations里加多个对象,用name区分。下面示例展示带参数启动的配置。
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Launch App",
"request": "launch",
"mainClass": "com.demo.App",
"args": "dev 8080",
"console": "internalConsole"
}
]
}
四、Maven项目与依赖管理
装好Maven扩展后,左侧会出现依赖视图。打开pom.xml所在文件夹,VS Code会全自动导入为Java项目,下载依赖并建好源码索引。比起命令行敲mvn,这里能直接跳转依赖源码,也能右键运行指定生命周期。
有时镜像慢会导致卡住,可在用户目录的.m2/settings.xml里换国内源。下面给出一段最小pom示例,展示如何声明编译级别与入口。
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.demo</groupId>
<artifactId>app</artifactId>
<version>1.0</version>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
</properties>
</project>
五、常见问题与排查
最常见问题是状态栏一直显示“Starting Java Language Server”。通常是JDK路径没配对,或者杀毒软件拦了进程。可打开命令面板执行Java: Clean Java Language Server Workspace重置。
另一个坑是代码能跑但没补全,多半是项目没被识别成源码根。在资源管理器右键文件夹选“Add Folder to Java Source Path”即可。理清这些点,VS Code写Java的体验就基本接近传统IDE了。