手把手教你用VS Code搭建Java开发环境（避坑指南）

最新推荐文章于 2025-10-30 10:02:15 发布

原创最新推荐文章于 2025-10-30 10:02:15 发布 · 3.1k 阅读

25 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

前言

还在为Eclipse卡顿烦恼？想用轻量级编辑器写Java代码？今天教你用VS Code从零搭建Java开发环境！全程保姆级教程+避坑指南，建议收藏备用（文末有常见问题汇总）！！！

环境准备三件套

1. JDK安装（重中之重）

推荐直接去Oracle官网下载最新LTS版本（目前是JDK 17），注意选择对应操作系统的安装包。安装时记得勾选"Add to PATH"选项（Windows用户特别注意）！

验证安装是否成功：

java -version

看到类似java version "17.0.8"的输出就对了！

2. VS Code本体

去官网下载安装包，建议选择System Installer版本。安装过程一路Next就行，但这两个选项建议勾选：

创建桌面快捷方式
添加到PATH环境变量

3. 必装扩展

打开VS Code后按Ctrl+Shift+X，搜索安装这些扩展：

Java Extension Pack（微软官方全家桶）
Maven for Java（项目管理必备）
Spring Boot Extension Pack（做Spring项目必装）

环境配置四步走

步骤1：配置JDK路径

按Ctrl+,打开设置，搜索java.home，填入你的JDK安装路径：

# Windows示例
C:\Program Files\Java\jdk-17

# MacOS示例
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

（路径不对会报红字错误！）

步骤2：创建Java项目

按Ctrl+Shift+P打开命令面板，输入Java: Create Java Project，选择：

项目类型：No build tools（纯Java项目）
输入项目名称
选择保存位置

VS Code会自动生成标准的项目结构：

├── src
│   └── main
│       └── java
│           └── App.java
└── .vscode
    └── settings.json

步骤3：配置调试环境

打开App.java文件，点击main方法上方的Run|Debug按钮，首次运行会自动生成.vscode/launch.json文件。重点检查这两个配置项：

"mainClass": "App", // 必须和你的主类名一致
"projectName": "demo" // 必须和项目文件夹名称一致

步骤4：运行测试

按F5启动调试，会在终端输出：

Hello World!

恭喜！你的第一个Java程序跑起来了！

高级配置技巧

1. 解决中文乱码

在settings.json中添加：

"java.jdt.ls.vmargs": "-Dfile.encoding=UTF-8"

2. 自定义代码模板

右键项目 -> Configure Java Runtime -> Code Templates，可以修改：

类注释模板
方法注释模板
文件头声明

3. 连接Maven仓库

按Ctrl+Shift+P执行Maven: Add Dependency，输入spring-boot-starter-web等依赖包，自动下载jar包！

常见问题排雷

❌ 找不到主类

检查：

类名是否与文件名一致
是否在正确的package路径下
launch.json中的mainClass是否带包名（如com.example.App）

❌ 无法识别System.out.println

按Ctrl+Shift+P执行Java: Clean Java Language Server Workspace，重启VS Code

❌ 编译版本不匹配

在pom.xml中添加（示例用JDK17）：

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

效率提升插件推荐

GitLens：代码版本追溯神器
Code Runner：一键运行代码片段
Live Share：实时协作编程
SonarLint：代码质量检测

结语

配置过程看似复杂，其实跟着步骤走20分钟就能搞定！现在你已经拥有了：
✅ 轻量级Java开发环境
✅ 智能代码补全
✅ 一键调试功能
✅ 项目管理能力

赶紧新建个Spring Boot项目试试吧！遇到问题欢迎评论区交流（常见问题已整理在文末附录）~