一、前言平时开发中大部分依赖直接在 Maven 写坐标即可自动下载。但是有一类 Jar 包永远无法从公共仓库下载商业授权 SDK、闭源第三方 Jar、公司内部工具包例如 SuperMap、ArcGIS、国产中间件等。本次我以SuperMap 超图 Jar 升级替换为例完整记录 Maven 手动安装、替换 Jar 的全过程以及大量新手必踩坑点。二、常见误区为什么普通依赖不用安装SuperMap 需要1. 公共开源包无需手动安装例如Spring、Mybatis、Mysql、Lombok、Hutool。存放在阿里云仓库 / Maven 中央仓库使用方式直接改版本号刷新 Maven 自动下载不需要任何命令不需要本地 Jar2. 商业/私有 Jar必须手动安装例如SuperMap、ArcGIS、付费SDK、自研Jar。公共仓库没有资源Maven 无法联网下载必须开发者手动把 Jar 放入本地 Maven 仓库手动放入仓库的动作mvn install:install-file 安装三、完整实操步骤替换 SuperMap 为例1. 准备工作拿到新版本的若干 Jar 包本次用到超图5个核心依赖com.supermap.datacom.supermap.data.conversioncom.supermap.mappingcom.supermap.layoutcom.supermap.analyst.spatialanalyst2. 环境要求新手必看必须配置 Maven 系统环境变量保证 CMD 输入mvn -v能识别。踩坑IDEA 内置 PowerShell 不会加载最新环境变量建议使用系统CMD执行安装命令。3. Jar 命名规范非常重要Jar 文件名必须带版本号例如com.supermap.data-12.0.1.jar原因Maven 依赖定位规则groupId artifactId version三者必须严格匹配。如果不带版本号安装命令识别不到文件直接报错文件不存在。4. 执行安装命令将 Jar 放入 pom.xml 同级目录CMD 进入当前项目目录。示例单条安装命令mvn install:install-file -Dfilecom.supermap.data-12.0.1.jar -DgroupIdcom.supermap -DartifactIdcom.supermap.data -Dversion12.0.1 -Dpackagingjar出现 BUILD SUCCESS 代表安装成功。4.1 补充一定要在 pom.xml 同级目录执行吗结论不是必须但新手强烈建议放在同级目录。1、原理直白解释Maven 安装命令中-Dfilexxx.jar是相对路径你当前 CMD 在哪一个文件夹它就去哪一个文件夹找 Jar。如果你写的是单纯文件名不带完整路径Jar 就必须和 CMD 工作目录保持一致。2、为什么教程都放 pom 同级路径最简单不用写超长绝对路径不容易出现Jar not exists文件找不到报错方便管理临时 Jar安装完统一删除3、不在同级目录怎么写进阶写法可以放在任意磁盘位置只要写绝对路径示例mvn install:install-file -DfileE:\jar\com.supermap.data-12.0.1.jar -DgroupIdcom.supermap -DartifactIdcom.supermap.data -Dversion12.0.1 -Dpackagingjar4、误区提醒安装命令不需要依赖 pom.xml哪怕没有 pom 文件这条命令照样能把 Jar 装进 Maven 仓库。很多人误以为必须在项目目录执行这是错误认知。唯一限制文件路径必须写对。5. 安装完成后原始Jar可以删除吗可以直接删除安装本质把Jar复制一份放入你的 Maven 本地仓库例如 D:\MavenRepository。项目后续编译、运行、打包全部读取仓库内的文件项目目录下的原始Jar只是临时安装介质无任何作用。6. IDEA 刷新依赖右侧 Maven 面板 → 刷新按钮依赖红叉消失版本替换完成。四、本次踩坑大全强烈收藏PowerShell 无法识别 mvn原因PowerShell 不会实时加载新配置的环境变量解决方案使用系统CMD。提示xxx.jar not exists原因文件名不一致、没有版本号、路径不对。mvnw 命令报错原因普通Maven项目没有mvnw脚本不要无脑复制网上教程。明明装了依赖还是爆红解决方案刷新Maven、清除IDEA缓存、重启项目。五、通俗易懂总结直白人话公共开源包改版本号刷新无需安装。商业私有包必须手动mvn安装进本地仓库。安装命令本质复制Jar登记坐标。安装完原始Jar可以删除不影响项目。Jar名称必须带版本号严格匹配pom依赖。新手尽量用系统CMD不要用IDEA终端。六、附加通用安装模板可永久收藏mvn install:install-file -Dfile你的jar文件名.jar -DgroupId公司组名 -DartifactId项目名 -Dversion版本号 -Dpackagingjar
