跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Javajava

Visual Studio Code + Maven:Java 项目安装配置与开发指南

详细讲解了在 Visual Studio Code 环境下配置 Maven 进行 Java 开发的步骤,包括 JDK 和 Maven 的环境变量设置、VS Code 必要插件的安装、Maven 标准项目的创建与 pom.xml 配置、依赖管理与版本控制、以及使用 Maven 命令进行构建打包和调试的方法,并提供了常见问题的解决方案。

Stephaine Walsh发布于 2026/3/26更新于 2026/10/26113 浏览

Visual Studio Code + Maven:Java 项目安装配置与开发指南

1. 环境准备

  • 安装 Visual Studio Code 官网下载安装:https://code.visualstudio.com

  • 安装 Maven 官网下载:https://maven.apache.org 配置环境变量:

# Linux/macOS: ~/.bashrc 或 ~/.zshrc
export MAVEN_HOME=/path/to/maven
export PATH=$MAVEN_HOME/bin:$PATH

# Windows: 系统环境变量
# 新增 MAVEN_HOME = C:\path\to\maven
# 添加 %MAVEN_HOME%\bin 到 Path

验证安装:

mvn -v
  • 安装 JDK 需 Java 8+(推荐 JDK 17):
# 检查版本
java -version

2. VS Code 插件安装

  1. 打开扩展商店(Ctrl+Shift+X)
  2. 搜索安装:
    • Java Extension Pack(必备工具包)
    • Maven for Java(Maven 项目管理)
    • Project Manager for Java(项目导航)

3. 创建 Maven 项目

  1. 命令面板(Ctrl+Shift+P)→ 输入 Maven: Create Project
  2. 选择模板:
    • maven-archetype-quickstart(标准 Java 项目)

生成项目结构:

demo-app
├── src/main/java
├── src/test/java
└── pom.xml

输入参数:

GroupId: com.example
ArtifactId: demo-app
Version: 1.0.0

4. 关键文件配置

pom.xml 示例:

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>demo-app</artifactId>
  <version>1.0.0</version>
  <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
  </properties>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.13.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

5. 开发与调试

  • 运行程序: 右键 → Run Java 或 F5 调试
  • 执行 Maven 命令: 右键 pom.xml → 选择命令:
    • mvn clean package(构建 JAR)
    • mvn test(运行测试)

编写代码: 在 src/main/java 创建类,如 App.java:

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello Maven!");
    }
}

6. 依赖管理

添加依赖到 pom.xml:

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-lang3</artifactId>
  <version>3.12.0</version>
</dependency>

VS Code 自动下载依赖(查看 Maven Dependencies 视图)

7. 构建与部署

生成可执行 JAR: 在 pom.xml 添加插件:

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals><goal>shade</goal></goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

运行:

mvn package

输出:target/demo-app-1.0.0.jar

8. 常见问题解决

问题现象解决方案
依赖下载失败检查网络或配置镜像仓库(settings.xml)
VS Code 不识别 Java 项目重启或执行 Java: Clean Workspace
Maven 命令未找到确认环境变量配置正确

提示:使用 `Ctrl+`` 打开集成终端可直接执行 Maven 命令

通过以上步骤,即可高效完成 Java 项目的开发、测试和部署。

目录

  1. Visual Studio Code + Maven:Java 项目安装配置与开发指南
  2. 1. 环境准备
  3. Linux/macOS: ~/.bashrc 或 ~/.zshrc
  4. Windows: 系统环境变量
  5. 新增 MAVEN_HOME = C:\path\to\maven
  6. 添加 %MAVEN_HOME%\bin 到 Path
  7. 检查版本
  8. 2. VS Code 插件安装
  9. 3. 创建 Maven 项目
  10. 4. 关键文件配置
  11. 5. 开发与调试
  12. 6. 依赖管理
  13. 7. 构建与部署
  14. 8. 常见问题解决

更多推荐文章

查看全部
  • OpenClaw 本地 AI 助手部署及飞书对接指南
  • ToDesk 内置 ToClaw AI:科技新闻日报自动化实战
  • 医疗大模型 LoRA 微调实战指南
  • 一个博客系统的 Python + Selenium 自动化测试记录
  • Python QQ 聊天机器人开发指南:从零搭建与插件扩展
  • LeetCode Hot 100 贪心算法详解
  • Windows 11 安装 Ubuntu 子系统
  • Java 25 Windows 环境变量配置指南
  • 视频行为分析系统 v3:C++ 与 Python 混合架构智能分析方案
  • 项目部署实战:Linux、Docker 与 Jenkins 流程
  • Llama-2-7b-chat-hf 本地部署全流程指南
  • Spring AI 聊天模型对比分析
  • JDK、IntelliJ IDEA 与 Maven 安装及配置指南
  • ToDesk 顺网云海马云部署 DeepSeek 大模型对比评测
  • 大模型时代企业 AI 发展趋势分析
  • 从决策树到随机森林:原理、实现与可解释性解析
  • 2023 年第十四届蓝桥杯省赛 C/C++ 大学 B 组真题及题解
  • Python 环境下 Gurobi 安装与配置指南
  • AI Agent 是什么?核心概念、架构与应用场景解析
  • Markdown2Html使用教程

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online