前言
还在为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项目试试吧！遇到问题欢迎评论区交流（常见问题已整理在文末附录）~