Visual Studio Code下的Maven环境建立

最新推荐文章于 2025-03-20 17:39:39 发布

tiantian_norain

最新推荐文章于 2025-03-20 17:39:39 发布

阅读量3k

点赞数

本文链接：https://blog.csdn.net/tiantian_norain/article/details/118817599

版权

本文指导如何在Windows和VSCode环境下安装Maven，包括环境变量配置、Maven的下载与安装，以及编写并执行第一个Maven程序的过程，适合初学者入门。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

这两天为了小学期的企业实训，提前学一下Maven，最开始也是最难受的一步就是配环境。这里我会假设你已经装好了Visual Studio Code（以下简称为VS Code）和较新版本的JDK。

1、Maven的下载和安装

首先从官网（https://maven.apache.org/download.cgi）下载Maven的包（我没有找到exe的引导文件，所以下载了zip包，它提供了多种格式的压缩包，应该都是可用的），然后解压到目标文件夹。

2、Windows上Maven环境的配置

打开“此电脑-属性-高级系统设置-环境变量”，在其中检查是否配置好了JAVA_HOME（应指向安装JDK的目录），如果没有，就先搜索Java的配置教程安装配置一下。如果配置好了，就可以配置Maven了，具体方式是：

新建→变量名：MAVEN_HOME，变量值：D:\apache-maven-3.8.1（这里填写你安装Maven的目录）→确定。

然后还需要找到Path（或PATH）变量，在其中添加名为“%MAVEN_HOME%\bin”的项。这里我为了保险，在用户变量和系统变量中都配置了以上两个步骤。

完成以上步骤后，不妨ctrl + R→搜索cmd→输入“mvn -version”，看看是否会输出版本信息，如果可以的话，你的Maven就安装好啦。接下来，打开你的VS Code，来配置一下环境，使你可以自由地在VS Code中使用Maven吧！

3、第一个Maven程序

恭喜你，可以开始进行你的第一个Maven程序啦！在此之前，你需要先了解一下Maven的目录组成，即——

工程文件夹的名字随便你取，但是后面的文件和文件夹名是约定俗成的，不能自由更改。

编写第一个Maven文件时，可以先在外部使用图形化界面建立这样的目录结构，然后互再在VS Code中在java文件夹中建立.java文件。pom.xml可以先拷贝现成的，也可以利用VS Code的插件自动生成（但是自动生成的有不兼容JDK版本的问题）。以下是我测试可用的pom.xml结构：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0"
         xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://maven.apache.org/POM/4.0.0
                https://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>
    
    <groupId>com.meiyu</groupId>
    <artifactId>maven01</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>maven01</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>14</maven.compiler.source>
        <maven.compiler.target>14</maven.compiler.target>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>2.6</version>
        </dependency>

    </dependencies>

</project>

然后你需要配置settings.xml文件，这个文件在apache-maven-3.8.1下的conf下。打开这个文件，其中可能需要更改的部分有：

①本地仓库地址（用于存jar包）改成你喜欢的地方（默认存在C盘中的一个.m2文件夹中，可能你的C盘容量不足，比如我）。你需要更改的语句是：

<localRepository>D:/m2/repository</localRepository>

中间的地址是我存储jar包的地址，你也可以改成你喜欢的。

②镜像换成国内的阿里云的公共仓库

可以去阿里云的Maven官网复制整段代码，替换掉默认的mirror代码。否则你的VS Code会到外网的中央仓库中下载资源，可能会比较慢。

<mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
</mirror>

建好了目录，写好java程序（这里指含有main函数的Hello程序），就可以打开cmd，尝试：先进入到src的上级文件夹（即项目文件夹中），使用mvn compile语句进行编译，在这里你可能会遭遇一些失败的情况，可以到网上查询相应的解决方法。

第一次执行这个命令会下载很多东西，慢慢等就好了，不会特别久。第二次以后就会比较快（如上图所示）。

然后使用mvn exec:java -D exec.mainClass="（java文件夹下到.java文件的路径，最后一项是.java的文件名）com.xxxx.demo.Hello"。这里有一个槽点，即你需要注意-D和后边别连着写，否则可能从cmd可以运行，但在VS Code的命令行里运行不通过。