9.4在 VS Code 中配置 Maven

chxii

已于 2025-05-27 15:29:14 修改

阅读量4.7k

点赞数 39

CC 4.0 BY-SA版权

分类专栏： java 文章标签： maven java

于 2025-05-24 11:39:31 首次发布

本文链接：https://blog.csdn.net/chxii/article/details/148175538

java 专栏收录该内容

91 篇文章

订阅专栏

在 VS Code 中配置 Maven 需要完成 Maven 环境安装

一、安装 Maven（如果未安装）

下载 Maven
访问 Apache Maven 官网，下载最新版本的 Maven（如apache-maven-3.9.9-bin.zip）。
解压文件
将下载的 ZIP 文件解压到本地目录，例如：D:\apache-maven-3.9.9。
配置环境变量
- MAVEN_HOME：指向 Maven 解压目录（如D:\apache-maven-3.9.9）。
- PATH：添加%MAVEN_HOME%\bin（Windows）
验证安装
打开终端执行：
```
mvn -version
```
若输出 Maven 版本信息，则安装成功。

二、配置 VS Code 中的 Maven

设置 Maven 路径
打开 VS Code 设置（Ctrl+ , 或 File > Preferences > Settings），搜索并编辑以下设置：

"maven.executable.path": "D:\\apache-maven-3.9.9\\bin\\mvn.cmd", // Windows

配置 Maven settings.xml

指定自定义的 settings 文件（可选）：
```
"maven.settingsFile": "D:\\apache-maven-3.9.9\\conf\\settings.xml",
```

三、修改`settings.xml`，添加国内镜像源（如阿里云）：

xml

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

2.设置本地仓库路径

四、创建和运行 Maven 项目

1. 创建新项目

方法一：使用 Maven 插件
1. 打开命令面板（Ctrl+Shift+P）。
2. 输入 Maven: Create Maven Project。
3. 选择 No archetype。
4. 按提示填写 GroupId、ArtifactId 等信息。

运行 Maven 命令

方法一：使用 Maven Explorer 视图
1. 点击左侧活动栏中的 Maven 图标。
2. 展开项目节点，右键点击 Lifecycle 目标（如package、install）执行。
方法二：使用命令行
在终端中进入项目目录，执行 Maven 命令：
```
mvn clean package
```

五、VS Code 无法识别 Maven 项目

确保安装了Maven for Java插件。
尝试重启 VS Code 或执行Java: Clean Java Language Server Workspace命令。

六、在 Maven 中查找软件包（依赖）的地址（即 Maven 坐标或仓库路径）可以通过以下多种方式实现

Maven Central Repository Search

地址：https://search.maven.org/
使用方法：
- 在搜索框中输入包名、类名或关键词（如 sqlite-jdbc）。
- 搜索结果会显示依赖的 Group ID、Artifact ID 和 Version，以及对应的仓库地址。
- 示例：查找 sqlite-jdbc 驱动：
  - Group ID: org.xerial
  - Artifact ID: sqlite-jdbc
  - 最新版本会显示在结果顶部。

Maven Repository（mvnrepository.com）

地址：https://mvnrepository.com/
特点：界面更简洁，支持按包名、版本筛选，直接生成 Maven 依赖代码。

示例：搜索 sqlite-jdbc，结果页会显示：

xml

<dependency>
    <groupId>org.xerial</groupId>
    <artifactId>sqlite-jdbc</artifactId>
    <version>3.42.0.0</version>
</dependency>

通过命令行查找依赖（Maven 命令）

使用 mvn dependency:search 命令在本地仓库和远程仓库中搜索依赖：

# 语法：mvn dependency:search -Dartifact=关键词
mvn dependency:search -Dartifact=sqlite-jdbc

输出结果会显示匹配的 Group ID、Artifact ID 和版本号。
注意：首次使用时需要联网下载索引，可能耗时较长。

通过框架官网或文档获取

官方文档：如 Spring、Hibernate 等框架会在文档中明确列出依赖的 Maven 坐标。
示例：SQLite JDBC 驱动的官方 GitHub 页面（https://github.com/xerial/sqlite-jdbc）会说明 Maven 依赖配置。

查找特定仓库的依赖（以阿里云镜像为例）

访问阿里云 Maven 仓库搜索页：仓库服务
在搜索框中输入包名，结果会显示依赖的坐标和仓库路径（通常与中央仓库一致，仅下载地址不同）。

Maven 依赖坐标说明

一个完整的 Maven 依赖由以下部分组成：

groupId：组织或项目的唯一标识（如 org.xerial）。
artifactId：项目或模块名称（如 sqlite-jdbc）。
version：版本号（如 3.42.0.0）。
packaging：打包类型（默认 jar，可选 war、pom 等）。

实战

在pom文件中，添加依赖项

    <dependencies>
        <dependency>
            <groupId>cglib</groupId>
            <artifactId>cglib</artifactId>
            <version>3.3.0</version>
        </dependency>
    </dependencies>

```
点击左边运行 编译 按钮。
```
配置的仓库中就多了依赖项。

添加运行插件配置

在 pom.xml 中添加以下插件

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>exec-maven-plugin</artifactId>
            <version>3.1.0</version>
            <configuration>
                <mainClass>com.example.Main</mainClass> <!-- 主类全限定名 -->
            </configuration>
        </plugin>
    </plugins>
</build>

5.运行项目

在终端执行