Maven安装配置与常见问题

Maven安装配置与常见问题

2026年5月16日·#javawebai/后端基础Java/Maven·467 字 2 分钟
浏览量加载中...
AI 摘要- DeepSeek

Maven下载安装、本地仓库配置、阿里云私服配置、环境变量配置、JDK版本关联及常见依赖下载问题解决

Maven安装配置#

下载#

下载地址:https://maven.apache.org/download.cgi

建议解压到没有中文、特殊字符的路径下。

解压后目录结构:

目录说明
bin/存放可执行命令(重点关注 mvn 命令)
conf/存放配置文件(settings.xml 后期需要修改)
lib/存放 Maven 依赖的 jar 包(Maven 本身也是 Java 开发)

配置步骤#

1. 配置本地仓库#

在 conf/settings.xml 中配置 <localRepository> 标签,指定本地仓库路径,用于存储下载的 jar 包。

<localRepository>E:/maven/repository</localRepository>

2. 配置阿里云私服#

中央仓库在国外,下载速度较慢。在 conf/settings.xml 的 <mirrors> 标签中添加:

<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>

3. 配置环境变量#

  • 新建系统变量 MAVEN_HOME,值为 Maven 解压安装目录
  • 在 Path 中添加 %MAVEN_HOME%\bin
  • 验证安装:命令行执行 mvn -v,输出版本信息表示安装成功

4. 配置关联 JDK 版本(可选)#

在 conf/settings.xml 的 <profiles> 中添加:

<profile>
<id>jdk-17</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>17</jdk>
</activation>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
</properties>
</profile>

常见问题:依赖下载失败#

问题现象:Maven 项目中添加的依赖未正确下载,右侧 Maven 面板中依赖报红,reload 重新加载也不会再下载。

产生原因:由于网络原因,依赖下载不完整,Maven 仓库中生成了 xxx.lastUpdated 文件,该文件不删除则不会重新下载。

解决方案:

  1. 根据 Maven 依赖坐标,找到仓库中对应的 xxx.lastUpdated 文件并删除,然后重新加载项目。
  2. 通过命令 del /s *.lastUpdated 批量递归删除指定目录下的所有 xxx.lastUpdated 文件。
  3. 依赖下载完成后,若 Maven 面板仍然报红,可关闭 IDEA 后重新打开加载项目。

注意事项#

  • 安装路径中避免包含中文和空格。
  • 配置 settings.xml 时注意标签的嵌套层级,<mirror> 必须在 <mirrors> 内部。
  • 首次下载依赖时耗时较长,需耐心等待。

评论区

[ 标签 ]
# AI37# AI 编程2# AI工具1# AI绘图1# AI辅助开发2# Ajax7# Apifox1# AstrBot3# Astro2# CC Switch1# CDN2# Claude Code1# claudecode2# ClaudeCode1# Cloudflare2# CloudFlare2# CloudFlare-ImgBed3# coc4# CSS10# DeepSeek6# deepseek2# DELETE1# Docker5# EdgeOne3# Gist1# git1# GitHub1# hexo-circle-of-friends1# HTML9# HTTP10# ImageManager1# Java23# java13# JavaScript11# JavaWeb113# JDBC7# JSON2# JUnit1# LangChain25# Linux4# Logback1# Maven17# Muse Spark1# Mybatis1# MyBatis18# MySQL45# MySql1# NapCat1# Node.js1# obsidian2# Obsidian5# OpenCode4# ORM1# PathVariable1# PicGo1# PyCharm1# Python70# RequestBody1# RequestMapping1# RESTful风格1# skills1# Slf4j1# SpringBoot37# SpringMVC5# SQL2# Streamlit5# Svelte2# TailwindCSS1# Telegram3# Tlias2# Vercel1# vscode2# Vue20# Waline3# Web3# WebDAV1# Web基础6# Web开发6# WinSCP1# YAML1# 三层架构1# 中二宣言1# 书籍1# 使用文档10# 写作1# 函数2# 刷步数1# 前端52# 动态1# 动漫1# 包1# 单词2# 博客8# 博客工作流1# 博客开发2# 参数接收1# 友链1# 反思2# 后端48# 图床6# 地图1# 备份2# 大模型1# 奇思妙想1# 存储1# 学习方法6# 学校1# 宝塔面板3# 宝宝10# 实战4# 对象1# 导航栏1# 工具2# 布局2# 开发1# 开发工具1# 开发规范1# 开心1# 异常处理1# 影视2# 微信1# 性能优化2# 总结1# 想法15# 感受1# 感悟11# 指南1# 提示词工程2# 插件5# 故障排除1# 效率工具2# 教程10# 数据分析9# 数据库27# 数据结构1# 文件操作2# 斩神1# 日常95# 日志框架1# 朋友圈1# 朱元璋1# 模块1# 模板1# 正则表达式2# 测试3# 游戏2# 爬虫7# 生活迁移1# 电影2# 电脑1# 碎碎念1# 视觉识别1# 类1# 类型注解1# 网络基础2# 网络教室1# 羊毛2# 脚本2# 脚本工具1# 自动化2# 蓝奏云1# 表单1# 订阅推荐2# 记录2# 评论系统1# 词根1# 词缀1# 说说1# 足迹1# 跑步2# 路径参数1# 转载2# 运动1# 部署11# 部落冲突1# 配置1# 随机图1# 面向对象5# 音乐3# 音标1# 项目实战11# 饮食1# 驼峰命名1# 高德地图1
[ 公告 ]

如果你喜欢,那么欢迎来到我的世界!

了解更多
[ 音乐 ]
封面

音乐

暂未播放

0:000:00
暂无歌词
找不到相关结果。
[ contents ]
[ 全部文章 ]