使用VSCode实现Java项目管理 Maven相关插件及配置（Maven换源）

最新推荐文章于 2025-10-01 22:26:38 发布
原创 最新推荐文章于 2025-10-01 22:26:38 发布 · 6w 阅读 · 260 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #maven #vscode

本文介绍了如何在VSCode中配置Maven以进行Java开发，包括Maven的下载与安装，环境变量配置，修改依赖下载源至阿里云，调整本地仓库路径，以及在VSCode中的具体设置，确保Maven插件能正常工作。

文章目录

前言

之前一直使用VSCode开发C、Go两种语言，现在需要对java进行学习，面对java的idea工具相对陌生，依旧想继续使用vscode作为开发工具，因此有了本篇文章

插件

无论是idea还是vscode，最核心的功能可能就是编辑了，很多工具的优秀特性也都是来自于优秀的插件，因此首先需要配置VSCode的插件

  • Language Support for Java™ by Red Hat
  • Debugger for Java
  • Java Test Runner
  • Maven for Java
  • Java Dependency Viewer
  • Spring Boot Tools
  • Spring Initializr Java Support
  • Spring Boot Dashboard
  • Tomcat
  • Jetty
  • CheckStyle
  • Java Linter
  • Java Decompiler
  • Lombok Annotations Support
  • Java Properties
    在这里插入图片描述

Maven配置

一、maven的安装

首先，先到官网去下载maven。这里是官网的地址：http://maven.apache.org/download.cgi 请选择最新的版本下载：

在这里插入图片描述
解压
在这里插入图片描述

二、路径配置

右键“计算机”，选择“属性”，之后点击“高级系统设置”，点击“环境变量”，来设置环境变量
在这里插入图片描述

有以下系统变量需要配置：

新建

变量名   MAVEN_HOME  

变量值：D:\Program Files\apache-maven-3.9.0

在这里插入图片描述

编辑系统变量 Path 添加变量值：

%MAVEN_HOME%\bin

在这里插入图片描述
最后检验配置是否成功：用win键+R，来打开命令行提示符窗口，即Dos界面，输入

mvn -version

若出现以下情况说明配置成功
在这里插入图片描述

三、修改Maven依赖下载源

1、首先打开自己的maven安装目录，下面找到conf文件夹，打开settings.xml文件

在这里插入图片描述
2、直接复制下面的内容覆盖，切换为阿里源

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <!-- localRepository
     | The path to the local repository maven will use to store artifacts.
     |
     | Default: ${user.home}/.m2/repository
    <localRepository>/path/to/local/repo</localRepository>
    -->
    <mirrors>
        <!-- mirror
         | Specifies a repository mirror site to use instead of a given repository. The repository that
         | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
         | for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
         |
        <mirror>
          <id>mirrorId</id>
          <mirrorOf>repositoryId</mirrorOf>
          <name>Human Readable Name for this Mirror.</name>
          <url>http://my.repository.com/repo/path</url>
        </mirror>
         -->
 
        <mirror>
            <id>alimaven</id>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
 
        <mirror>
            <id>uk</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>http://uk.maven.org/maven2/</url>
        </mirror>
 
        <mirror>
            <id>CN</id>
            <name>OSChina Central</name>
            <url>http://maven.oschina.net/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
 
        <mirror>
            <id>nexus</id>
            <name>internal nexus repository</name>
            <!-- <url>http://192.168.1.100:8081/nexus/content/groups/public/</url>-->
            <url>http://repo.maven.apache.org/maven2</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
 
    </mirrors>
</settings>

四、修改库文件路径

maven作为非常强大的一个组织和管理工具，但是它的默认仓库放在C盘文档目录下，这样万一重装电脑会将下载的

jar包全部消除，而且永久以后库文件积累太多，容易造成电脑缓慢。对于项目来说重新部署虽然不是难事，但是我们

可以做到将仓库搬到另一个位置，这样就可以一劳永逸了。

使用ctrl+f在settings.xml寻找localrepository字样，出现如下所示，下面将这个标签改为你想要的路径：
在这里插入图片描述
例如

 <localRepository>D:/Program Files/apache-maven-repository/repository</localRepository>

完整settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <!-- localRepository
     | The path to the local repository maven will use to store artifacts.
     |
     | Default: ${user.home}/.m2/repository
    <localRepository>/path/to/local/repo</localRepository>
    -->
    <localRepository>D:/Program Files/apache-maven-repository/repository</localRepository>
    <mirrors>
        <!-- mirror
         | Specifies a repository mirror site to use instead of a given repository. The repository that
         | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
         | for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
         |
        <mirror>
          <id>mirrorId</id>
          <mirrorOf>repositoryId</mirrorOf>
          <name>Human Readable Name for this Mirror.</name>
          <url>http://my.repository.com/repo/path</url>
        </mirror>
         -->
 
        <mirror>
            <id>alimaven</id>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
 
        <mirror>
            <id>uk</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>http://uk.maven.org/maven2/</url>
        </mirror>
 
        <mirror>
            <id>CN</id>
            <name>OSChina Central</name>
            <url>http://maven.oschina.net/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
 
        <mirror>
            <id>nexus</id>
            <name>internal nexus repository</name>
            <!-- <url>http://192.168.1.100:8081/nexus/content/groups/public/</url>-->
            <url>http://repo.maven.apache.org/maven2</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
 
    </mirrors>
</settings>

创建你在settings.xml中指定真实仓库路径，并将修改后的settings.xml文件复制一份放在当前的目录下（原来的不要删除掉）
在这里插入图片描述

五、配置VSCode

(Ctrl+,) ，搜索

java.configuration.maven

输入maven的settings.xml路径

注意：这里的路径都是之前新建的依赖下载位置的路径

在这里插入图片描述
搜索

maven.executable.path

在这里插入图片描述

注意：这里填写的路径是mvn可执行文件的绝对路径

上述过程也可以直接添加json代码到setting中

"java.configuration.maven.globalSettings": "D:\\Program Files\\apache-maven-repository\\settings.xml",
"java.configuration.maven.userSettings": "D:\\Program Files\\apache-maven-repository\\settings.xml",
"maven.executable.path": "D:\\Program Files\\apache-maven-3.9.0\\bin\\mvn",

Maven使用

经过我们的不屑努力，现在就可以通过vscode实现对maven的管理了
在这里插入图片描述

在VSCode中创建Maven工程
DpgrMl的博客
09-23 2888
你可以进一步探索Maven的功能，例如添加更多的依赖、配置构建插件等，以满足你的具体需求。在搜索框中输入"Maven for Java"，并安装该扩展。请注意，将"com.example"和"my-maven-project"替换为你自己的groupId和artifactId。在VSCode的资源管理器中，展开工程文件夹并找到"pom.xml"文件。在资源管理器中右键点击新建的文件夹，并选择“在终端中打开”。右键点击"pom.xml"文件，并选择“使用Maven项目管理器”打开它。
vscode插件(个人正在用的)
weixin_68658847的博客
12-30 1万+
vscode插件(个人正在用的)
vscode-maven：VSCode扩展“ Maven for Java”
02-04
Java Maven 产品特点 VS Code的Maven扩展。 它提供了一个项目浏览器和执行Maven命令的快捷方式，从而为使用Maven的Java开发人员改善了用户体验。 支持从Maven Archetype生成项目。 支持生成有效的POM。 提供常见目标，插件目标和自定义命令的快捷方式。 保留命令历史记录以快速重新运行。 要求 Java Maven / Maven包装器 有关故障排除，请参阅的页面。 基本用法 Maven资源管理器该扩展程序将扫描工作区中的pom.xml ，并在边栏中显示所有Maven项目及其模块。 运行插件目标该扩展程序解析Maven项目的有效pom，并按层
在vscode 里配置maven
hxl95810的专栏
12-27 1万+
1、打开自己的maven安装目录，下面找到conf文件夹，打开settings.xml文件。打开vscode菜单 文件 > 首选项 > 设置 搜索maven。点击扩展搜索java点击安装会自动安装其它相关插件。好了现在可以创建maven项目了。设置maven配置文件路径。2、设置本地仓库路径。四、配置VSCode。
【VSCode中Java开发环境配置的三个层级之Maven篇】（Windows版）
最新发布
lez1021的博客
10-01 1089
本文介绍了如何在VSCode中配置Maven开发环境。首先下载并安装Maven，配置系统PATH使其可识别mvn命令。然后修改settings.xml添加阿里云镜像源以加速依赖下载。通过VSCode创建Maven项目，测试运行Hello World程序。最后在pom.xml中添加SLF4J日志依赖，执行mvn install测试源配置是否成功。文章还预告了后续将介绍pom.xml配置、settings.xml优化及常用mvn命令等内容。Maven极大提升了Java项目的依赖管理和构建效率。
Windows 系统下vscode配置 Maven 的详细步骤
weixin_73592609的博客
04-21 3980
记住这个解压路径，后续配置会用到。我的是"D:\JAVA\apache-maven-3.9.9"（注意小写），如果出现 Maven 的版本信息，说明 Maven 已成功安装和配置。这样可以避免本地仓库占用 C 盘空间，并且在重装系统时可保留下载的依赖。将下载好的压缩包解压到你希望安装 Maven 的目录，例如。这样可以加快 Maven 下载依赖的速度。打开命令提示符（Win 键 + R，输入。打开 Maven 安装目录下。回车），在命令行中输入。
Maven配置仓储和配置国内镜像
zy0412326的专栏
04-12 680
2、打开Maven的安装路径，找到conf下， 下面是我自己的安装路径。4、配置国内镜像，一般都是阿里的，把这段代码加进去就可以了。1、安装Maven 我在之前的文章 写过一点都不难。3、打开settings.xml文件。PS:严重BS那些打马赛克的。推荐使用VSCODE打开。
VSCode的maven插件配置问题
larntin
06-17 1339
vscode安装了java开发套件之后，配置maven的自定义仓库位置不生效的问题
9.4在 VS Code 中配置 Maven
chxii的专栏
05-24 6562
在 VS Code 中配置 Maven 需要完成 Maven 环境安装。
Visual Studio Code （VSCode）使用之Maven管理依赖的项目启动
qq_41099935的博客
05-03 1万+
文章目录前言一、VSCode需要安装的插件二、使用步骤1.引入库2.读入数据总结 前言 本文主要介绍在VScode中使用tomcat启动由maven管理依赖的（javaweb）项目。若使用的是其他开发工具，可以跳过了～ 由于公司的某些原因，不得不摒弃IDEA（懂的都懂）。在VSCode和Eclipse中徘徊，大学期间就使用的Eclipse，考虑到之前的使用感受，决定还是试试VSCode好了【手动🐶】。 下面的内容基于**M1(Pro)**芯片的MacOS系统，JDK 1.8、Tomcat 9.0.58、M
vscode-maven-0.44.0.vsix
07-19
它提供了项目资源管理器和执行 Maven 命令的快捷方式，从而提升了使用 Maven 的 Java 开发人员的用户体验。 支持从Maven Archetype生成项目。 支持生成有效的POM。 提供常见目标、插件目标和自定义命令的快捷方式。 ...
VSCode高效配置Maven开发Java
胡西风的博客
07-10 1334
摘要：本文详细介绍了在VSCode中使用Maven进行Java项目开发的完整流程。内容包括：安装必要扩展（Java扩展包、Maven插件等）、配置Maven环境、创建项目的两种方法（命令行和图形界面）、标准项目结构说明、执行Maven命令的方式、pom.xml配置示例、程序运行方法以及常见问题解决方案。还推荐了有助于Java开发的实用扩展插件，帮助开发者在VSCode中高效完成Maven项目管理。（149字）
【Java】【Maven】Maven安装配置使用
LazyFish的博客
04-25 1721
jar包问题项目结构的问题整体项目的生命流程。
vscode搭建springboot maven多模块项目
weixin_43292547的博客
09-19 2838
【代码】vscode搭建springboot maven多模块项目。
【JDK、Maven、Git、PostgreSQL】VSCode后端开发环境配置样例
m0_63997099的博客
10-17 2105
VSCODE和IDEA不一样，其开发工具需要在系统环境变量中配置好，因此我们下载的环境得配置系统环境变量。
Visual Studio Code下的Maven环境建立
tiantian_norain的博客
07-16 3385
这两天为了小学期的企业实训，提前学一下Maven，最开始也是最难受的一步就是配环境。这里我会假设你已经装好了Visual Studio Code（以下简称为VS Code）和较新版本的JDK。 1、Maven的下载和安装 首先从官网（https://maven.apache.org/download.cgi）下载Maven的包（我没有找到exe的引导文件，所以下载了zip包，它提供了多种格式的压缩包，应该都是可用的），然后解压到目标文件夹。 2、Windows上...
vscode搭建javaweb项目(jdk、maven环境变量配置、Tomcat下载安装)-小白入门篇
HaiJaine的博客
05-16 1万+
一、下载vscode 下载链接 https://code.visualstudio.com/ 二、下载jdk 下载链接 https://www.oracle.com/java/technologies/javase-jdk14-downloads.html 解压下载的jdk压缩包，记住路径（后面配置环境变量需要） 配置jdk环境变量 变量名：JAVA_HOME 变量值：D:\Program Files\Java\jdk-14 path中的环境变量：%JAVA_HOME%\bin 和 %JA
VSCode中开发JavaWeb项目（Maven+Tomcat+热部署）
热门推荐
weixin_49666086的博客
07-29 1万+
在VSCode中开发JavaWeb项目，包括Maven构建、Community Server Connectors插件部署Tomcat、Deploy热部署等。
vscode 配置maven
08-16
### 安装 Maven 在 VSCode 中配置 Maven 支持 Java 开发之前，确保系统中已经安装了 Maven。可以从 [Maven 官方网站](https://maven.apache.org/download.cgi) 下载并解压 Maven，然后设置环境变量 `MAVEN_HOME` 和 `PATH` 以包含 Maven 的 `bin` 目录[^1]。 ### 配置 VSCode 以支持 Maven 在 VSCode 中，可以通过安装扩展插件和手动配置来实现 Maven 的集成。推荐使用 [Maven for Java](https://marketplace.visualstudio.com/items?itemName=oracle-labs-java.java-maven) 插件来增强 Maven 的支持[^1]。安装完成后，VSCode 将提供以下功能： - 项目结构管理 - Maven 生命周期操作（如 clean、compile、package） - 自动下载依赖 - 依赖冲突检测 ### 创建 Maven 项目 在终端中使用以下命令创建一个新的 Maven 项目： ```bash mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false ``` 该命令将生成一个基础的 Maven 项目结构，包含 `pom.xml` 文件和默认的 `src` 目录结构[^1]。 ### 配置 `pom.xml` 文件 Maven 项目的核心是 `pom.xml` 文件，它包含了项目的配置信息，包括依赖项、插件和构建配置。例如，添加一个依赖项： ```xml <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13.2</version> <scope>test</scope> </dependency> </dependencies> ``` 保存 `pom.xml` 后，VSCode 会自动下载所需的依赖库，并将其添加到项目中[^1]。 ### 使用 VSCode 运行 Maven 命令 VSCode 提供了对 Maven 生命周期操作的直接支持。可以在命令面板（`Ctrl+Shift+P`）中搜索 Maven 相关命令并执行以下操作： - `Maven: Clean`：清理项目 - `Maven: Compile`：编译项目 - `Maven: Package`：打包项目 - `Maven: Install`：将项目安装到本地仓库 ### 配置 Maven 的 JDK 版本 为了确保 Maven 使用正确的 JDK 版本，可以在 `pom.xml` 中添加以下配置： ```xml <properties> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> </properties> ``` 上述配置将确保 Maven 使用 JDK 17 进行编译。根据实际安装的 JDK 版本调整 `source` 和 `target` 的值[^1]。 ### 调试 Maven 项目 VSCode 提供了内置的调试器支持，可以通过 `launch.json` 文件配置调试选项。例如，以下是一个调试配置示例： ```json { "version": "0.2.0", "configurations": [ { "type": "java", "request": "launch", "name": "Debug (Launch)", "mainClass": "com.example.App", "projectName": "demo" } ] } ``` 通过该配置，可以在 VSCode 中启动调试会话并逐步执行代码[^1]。 ### 集成 Git 和版本控制 VSCode 提供了对 Git 的原生支持，可以轻松地将 Maven 项目与 Git 仓库集成。可以通过左侧活动栏中的 Git 图标提交更改、查看差异和推送代码到远程仓库[^1]。 ###
评论 7
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值