一、必装插件清单(复制名称到 VS Code 扩展面板搜索安装)
- Extension Pack for Java(微软官方,核心一站式插件包)
- Language Support for Java™ by Red Hat(代码补全/语法检查)
- Debugger for Java(断点调试工具)
- Maven for Java(Maven 项目支持)
- Gradle for Java(Gradle 项目支持,按需安装)
- SonarLint(实时代码质量检查)
- Java Test Runner(单元测试运行器,支持 JUnit/TestNG)
- Java Refactoring Assistant(重构增强工具)
- Visual Studio IntelliCode(AI 辅助代码补全)
- Material Icon Theme(文件图标美化,提升辨识度)
二、settings.json 优化配置(直接替换或追加到用户设置)
打开方式:VS Code → Ctrl+, → 搜索“settings.json” → 编辑用户设置

{
// 1. JDK 配置(替换为你的 JDK 路径)
"java.home": "C:Program FilesEclipse Adoptiumjdk-17.0.9+9",
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "C:Program FilesEclipse Adoptiumjdk-17.0.9+9",
"default": true
}
],
// 2. 性能优化(大型项目必备)
"java.jdt.ls.vmargs": "-XX:+UseParallelGC -XX:HeapDumpPath=/tmp -Xms1G -Xmx4G -XX:MaxPermSize=512M",
"java.configuration.updateBuildConfiguration": "interactive", // 手动触发构建配置更新
"java.saveActions.organizeImports": true, // 保存时自动整理导入包
// 3. 代码格式化配置
"java.format.settings.url": "https://raw.githubusercontent.com/google/styleguide/gh-pages/eclipse-java-google-style.xml", // 谷歌代码风格
"java.format.comments.enabled": true, // 格式化注释
"editor.formatOnSave": true, // 保存时自动格式化
"editor.formatOnType": false, // 输入时不自动格式化(避免干扰)
// 4. 代码编辑增强
"editor.suggest.snippetsPreventQuickSuggestions": false,
"editor.snippetSuggestions": "top", // 代码片段优先显示
"java.completion.favoriteStaticMembers": [
"org.junit.Assert.*",
"org.junit.jupiter.api.Assertions.*",
"java.util.Arrays.*",
"java.util.Collections.*"
], // 静态方法补全优先级提升
// 5. 调试配置
"java.debug.settings.hotCodeReplace": "auto", // 自动热部署(支持无状态代码修改)
"java.debug.settings.showHex": true, // 调试时显示十六进制值
"java.debug.settings.showStaticVariables": true, // 显示静态变量
// 6. 测试配置
"java.test.config": {
"default": {
"vmArgs": "-ea" // 启用断言
}
},
// 7. 其他优化
"files.exclude": {
"**/.classpath": true,
"**/.project": true,
"**/.settings": true,
"**/.factorypath": true
}, // 隐藏无用配置文件
"search.exclude": {
"**/target/**": true
} // 搜索时排除编译目录
}
三、Maven 镜像配置(加速依赖下载)
1. 全局配置(推荐)
找到 Maven 安装目录 → conf → settings.xml,替换 节点内容:
aliyunmaven central 阿里云中央仓库 https://maven.aliyun.com/repository/public aliyunmaven-spring spring-milestones,spring-snapshots 阿里云 Spring 仓库 https://maven.aliyun.com/repository/spring repo1 central http://repo1.maven.org/maven2/ jdk-17 true 17 17 17 17
2. 项目级配置(仅当前项目生效)
在项目的 pom.xml 中添加 节点:
aliyunmaven https://maven.aliyun.com/repository/public true false
四、常用快捷键汇总(提升开发效率)
1. 通用编辑
| 快捷键 | 功能描述 |
|---|---|
| Ctrl+Shift+X | 打开扩展面板 |
| Ctrl+, | 打开设置 |
| Ctrl+Shift+P | 打开命令面板 |
| Ctrl+N | 新建文件 |
| Ctrl+S | 保存文件 |
| Ctrl+F | 查找 |
| Ctrl+H | 替换 |
| Ctrl+D | 选中当前单词(多按多选) |
| Ctrl+Z | 撤销 |
| Ctrl+Shift+Z | 反撤销 |
| Ctrl+Shift+F | 全局查找 |
2. Java 专属
| 快捷键 | 功能描述 |
|---|---|
| Alt+/ | 代码补全(同 Ctrl+Space) |
| Ctrl+Shift+O | 自动导入包(整理无用导入) |
| Ctrl+Shift+T | 查找类(全局搜索) |
| Ctrl+Alt+B | 跳转到方法实现 |
| Ctrl+Click | 跳转到定义 |
| Alt+Left/Right | 后退/前进(导航历史) |
| Ctrl+Alt+T | 包围代码(try-catch/if 等) |
| Alt+Shift+R | 重命名(类/方法/变量) |
| Alt+Shift+M | 提取方法 |
| Alt+Shift+L | 提取局部变量 |
| Ctrl+Shift+B | 编译项目 |
3. 调试相关
| 快捷键 | 功能描述 |
|---|---|
| F5 | 启动/继续调试 |
| F10 | 单步跳过(不进入方法) |
| F11 | 单步进入(进入方法) |
| Shift+F11 | 单步退出 |
| Ctrl+F5 | 运行不调试 |
| Ctrl+Shift+F5 | 重启调试 |
| Ctrl+F2 | 停止调试 |
4. 测试相关
| 快捷键 | 功能描述 |
|---|---|
| Ctrl+Shift+T | 生成测试类 |
| Alt+Shift+X, T | 运行当前测试类 |
| Alt+Shift+D, T | 调试当前测试类 |
五、使用说明
配置生效与验证
插件安装完成后,务必重启 VS Code,确保 JDK 路径配置正确(可通过 java -version 验证)。针对 Maven 镜像配置,重启 VS Code 或右键 pom.xml 选择“Maven: Update Project”即可使配置立即生效。此外,所有快捷键均可在 VS Code 的键盘快捷方式(Ctrl+K Ctrl+S)中根据习惯自定义修改,以提升操作效率。
高级定制技巧
若需自定义代码模板,只需按 Ctrl+Shift+P 打开命令面板,输入“Java: Configure User Snippets”,随后编辑 java.json 文件即可实现个性化代码片段管理。这份清单全面覆盖了 Java 开发全流程需求,您可直接复制使用,配置后即可快速搭建稳定、高效的 VS Code Java 开发环境,完美适用于中小型项目、微服务架构及多语言协同开发场景。


