基于Maven的Java项目如何引入私有Git仓库中的Java包？

别发愁，我给你整理了几个实用的方案，完美适配你这种「从非Maven的私有Git仓库引入生成的Java类」的场景：

方案1：Git子模块 + Maven编译配置（适合需同步更新的场景） #

如果后续需要经常同步远程仓库里的生成类更新，这个方案最省心：

• 第一步，把远程私有Git仓库作为子模块加到你的项目里：

  git submodule add <你的私有Git仓库地址> ./proto-repo
  

  执行完后，你的项目根目录会多出一个proto-repo文件夹，就是远程仓库的完整内容。
• 第二步，修改你项目的pom.xml，给Maven编译插件添加额外的源码路径，把远程仓库里的生成类纳入编译范围：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.11.0</version> <!-- 版本可以根据你的Maven环境调整 -->
              <configuration>
                  <source>1.8</source> <!-- 改成你项目用的Java版本 -->
                  <target>1.8</target>
                  <includes>
                      <include>**/*.java</include>
                      <include>./proto-repo/target/java/com/example/test/**/*.java</include>
                  </includes>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

• 第三步，执行mvn clean compile，Maven就会把这些生成类和你自己的代码一起编译了，打包的时候也会自动包含进去。
• 后续要同步远程仓库的更新，只需要执行：

  git submodule update --remote
  

方案2：手动打包Jar作为本地依赖（适合不常更新的场景） #

如果生成类不会频繁变动，手动打包Jar的方式更简单：

• 先把远程私有Git仓库克隆到本地：

  git clone <你的私有Git仓库地址>
  

• 进入克隆下来的仓库里的target/java目录，把com目录打包成Jar：

  jar cvf proto-generated.jar com/
  

• 在你的项目根目录新建一个lib文件夹，把刚才生成的proto-generated.jar放进去。
• 修改你的项目pom.xml，添加这个本地Jar的依赖：

  <dependencies>
      <dependency>
          <groupId>com.example</groupId> <!-- 自定义一个groupId -->
          <artifactId>test-proto</artifactId> <!-- 自定义artifactId -->
          <version>1.0.0</version> <!-- 自定义版本号 -->
          <scope>system</scope>
          <systemPath>${project.basedir}/lib/proto-generated.jar</systemPath>
      </dependency>
  </dependencies>
  

  💡 注意：system scope的依赖默认不会被打包到最终的Jar/War里，如果需要包含进去，还要添加插件配置：

  <build>
      <plugins>
          <!-- 如果是Web项目用maven-war-plugin，普通Java项目用maven-jar-plugin -->
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-war-plugin</artifactId>
              <version>3.3.2</version>
              <configuration>
                  <webResources>
                      <resource>
                          <directory>lib</directory>
                          <targetPath>WEB-INF/lib</targetPath>
                          <includes>
                              <include>*.jar</include>
                          </includes>
                      </resource>
                  </webResources>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

方案3：把远程仓库改成Maven项目（推荐长期维护的场景） #

如果这个远程仓库是你们团队自己维护的，最推荐把它改成Maven项目，后续依赖管理会更规范：

• 到远程仓库的根目录，新建一个pom.xml，内容如下（可以根据实际情况调整groupId、artifactId和Java版本）：

  <?xml version="1.0" encoding="UTF-8"?>
  <project xmlns="http://maven.apache.org/POM/4.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
  
      <groupId>com.example</groupId>
      <artifactId>proto-generated</artifactId>
      <version>1.0.0-SNAPSHOT</version>
      <packaging>jar</packaging>
  
      <build>
          <sourceDirectory>target/java</sourceDirectory> <!-- 指定生成的Java类目录作为源码目录 -->
          <plugins>
              <plugin>
                  <groupId>org.apache.maven.plugins</groupId>
                  <artifactId>maven-compiler-plugin</artifactId>
                  <version>3.11.0</version>
                  <configuration>
                      <source>1.8</source>
                      <target>1.8</target>
                  </configuration>
              </plugin>
          </plugins>
      </build>
  </project>
  

• 把这个项目部署到你们团队的私有Maven仓库（比如Nexus、Artifactory），然后在你的项目里直接添加依赖即可：

  <dependencies>
      <dependency>
          <groupId>com.example</groupId>
          <artifactId>proto-generated</artifactId>
          <version>1.0.0-SNAPSHOT</version>
      </dependency>
  </dependencies>
  

  记得在你的项目pom.xml里配置好私有Maven仓库的地址哦。

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