如何将无构建工具的Eclipse/VSCode Java项目转换为基于Maven的项目

1. 现有项目改造为Maven项目的操作步骤 #

• 先备份当前项目全量文件，避免改造过程中操作失误丢失内容
• 若使用IDEA/Eclipse/VS Code等IDE，可直接在项目根目录右键选择「转换为Maven项目」（不同IDE入口略有差异，本质是自动生成pom.xml基础骨架）
• 手动改造的话直接在项目根目录新建pom.xml，补全基础的groupId、artifactId、version信息，在properties节点配置项目使用的JDK版本，再按照Maven标准目录结构调整文件位置：Java源码迁移到src/main/java，配置类等资源文件迁移到src/main/resources，测试代码迁移到src/test/java，测试资源迁移到src/test/resources
• 调整完成后执行mvn clean compile验证项目结构合法性，无编译报错即改造完成

2. 切换为JFrog Artifactory依赖的配置方法 #

• 先确认所有需要用到的JAR包已经上传到公司的JFrog Artifactory仓库，提前拿到每个依赖对应的groupId、artifactId、version坐标
• 打开Maven全局配置文件settings.xml（默认存放在用户目录下的.m2文件夹内），在<servers>节点下添加JFrog的鉴权配置，id要和后续pom文件里的仓库id保持一致：

<server>
  <id>jfrog-artifactory</id>
  <username>你的JFrog账号</username>
  <password>你的JFrog密码/授权访问令牌</password>
</server>

• 再在项目pom.xml的<repositories>节点下添加JFrog私有仓库配置，id和上一步settings里配置的id保持一致：

<repository>
  <id>jfrog-artifactory</id>
  <url>公司JFrog私有仓库的访问地址</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

• 最后删除项目里原有的本地JAR引用，将每个JAR对应的坐标写入pom.xml的<dependencies>节点即可，执行mvn dependency:resolve验证依赖是否可以正常拉取

3. .gitignore忽略规则配置方法 #

• 直接在项目根目录新建.gitignore文件，写入以下通用Java+Maven项目的忽略规则，覆盖所有编译产物、构建生成文件、IDE配置等非源代码内容：

# 编译生成的class字节码文件
*.class

# 打包生成的归档文件
*.jar
*.war
*.ear

# Maven构建生成的目录与缓存
target/
.m2/
.mvn/

# 各IDE生成的本地配置文件
.idea/
*.iml
*.ipr
*.iws
.vscode/
.settings/
.project
.classpath

# 日志类文件
*.log
logs/

# 临时缓存文件
*.tmp
*.temp

• 保存规则后如果之前已经有无关文件被Git追踪，执行git rm -r --cached .再重新执行git add .，即可将历史提交的无关文件从Git追踪列表中移除，后续这类文件就不会再显示为Untraced状态

内容的提问来源于stack exchange，提问作者tarekahf