前置准备
动手之前,得先把地基打好。正式配置前,请确保本地已准备好以下基础组件:
- JDK(推荐 JDK 8/11/17,Maven 对新版本兼容性较好)
- Maven(官网下载 apache-maven-3.6+ 版本)
- 环境变量配置
- JAVA_HOME 指向 JDK 安装目录
- MAVEN_HOME 指向 Maven 安装目录
- 将 %MAVEN_HOME%\bin 和 %JAVA_HOME%\bin 加入系统 Path
- 验证方式:终端执行
java -version和mvn -v,能正常输出版本信息即成功。
安装核心插件
启动 VSCode,在左侧扩展栏(Ctrl+Shift+X)搜索并安装以下插件:
- Extension Pack for Java:微软官方 Java 扩展包,包含核心开发工具
- Maven for Java:支持 pom.xml 编辑、依赖管理及生命周期执行
- Project Manager for Java(可选):方便管理多个项目
配置运行环境路径
若编辑器未能自动定位到 JDK 或 Maven 路径,需手动指定。打开设置(Ctrl+,),搜索 java.configuration.runtimes,点击「编辑 in settings.json」添加 JDK 配置(示例为 JDK 11):
"java.configuration.runtimes": [
{
"name": "JavaSE-11",
"path": "你的 JDK 安装路径(如 D:\\jdk-11.0.19)",
"default": true
}
]
接着搜索 maven.executable.path,设置 Maven 可执行文件路径(如 D:\\apache-maven-3.9.6\\bin\\mvn.cmd)。如有自定义镜像需求,还可配置 maven.settings.file 指向 settings.xml 路径。
创建或导入项目
新建项目
打开命令面板(Ctrl+Shift+P),输入 Maven: Create Maven Project。选择 Archetype(推荐 maven-archetype-quickstart),按提示输入 Group Id、Artifact Id 等信息,选择保存路径后等待脚手架生成。
打开现有项目
直接点击「文件」→「打开文件夹」,选中包含 pom.xml 的根目录。VSCode 会自动识别并加载依赖,首次可能需要几分钟,耐心等待即可。

