如何将IntelliJ IDEA项目JDK配置纳入Git版本控制？

问题根源 #

当IDE找不到本地指定的Corretto 1.8时，会自动匹配与设置的语言级别（1.8）兼容的最新LTS JDK（此处为Corretto 11），并修改misc.xml的JDK配置。要实现团队统一使用Corretto 1.8，需从配置共享、行为限制、构建约束三个维度入手。

具体解决方案 #

1. 提交jdk.table.xml到Git（核心步骤） #

IntelliJ的JDK定义存储在.idea/jdk.table.xml，这个文件记录了JDK的名称、版本、路径等关键信息，提交它可以让团队共享统一的JDK配置：

<?xml version="1.0" encoding="UTF-8"?>
<application>
  <component name="ProjectJdkTable">
    <jdk version="2">
      <name value="corretto-1.8" />
      <type value="JavaSDK" />
      <version value="1.8" />
      <homePath value="$USER_HOME$/.jdks/amazon-corretto-1.8.0_XXX" />
      <roots>
        <annotationsPath>
          <root type="com.intellij.openapi.roots.OrderRootType$ANNOTATIONS" />
        </annotationsPath>
        <classPath>
          <root type="com.intellij.openapi.roots.OrderRootType$CLASSES" url="jar://$USER_HOME$/.jdks/amazon-corretto-1.8.0_XXX/jre/lib/rt.jar!/" />
          <!-- 保留本地配置中其他classPath根节点 -->
        </classPath>
        <javadocPath>
          <root type="com.intellij.openapi.roots.OrderRootType$JAVADOC" url="https://docs.oracle.com/javase/8/docs/api/" />
        </javadocPath>
        <sourcePath>
          <root type="com.intellij.openapi.roots.OrderRootType$SOURCES" url="jar://$USER_HOME$/.jdks/amazon-corretto-1.8.0_XXX/src.zip!/" />
        </sourcePath>
      </roots>
      <additional />
    </jdk>
  </component>
</application>

替换XXX为实际的Corretto 1.8版本号，用$USER_HOME$适配不同系统的用户目录。

2. 禁用IDE自动下载JDK功能 #

通过设置关闭IDE的自动下载行为：

• 进入Build, Execution, Deployment > Build Tools > Maven > Importing（Maven项目），取消勾选Automatically download: Sources和Automatically download: Documentation
• 进入Build, Execution, Deployment > Build Tools > Gradle（Gradle项目），取消勾选Download JVM automatically
• 全局设置：File > New Projects Setup > Settings for New Projects，重复上述步骤，避免新项目自动下载

3. 用构建工具强制约束JDK版本（推荐） #

仅靠IDE配置不够，结合Maven/Gradle的约束，能从编译层面强制统一版本：

• Maven：在pom.xml中添加：

  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.release>8</maven.compiler.release>
  </properties>
  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.11.0</version>
          <configuration>
            <source>8</source>
            <target>8</target>
            <fork>true</fork>
            <executable>$USER_HOME$/.jdks/amazon-corretto-1.8.0_XXX/bin/javac</executable>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
  

• Gradle：在build.gradle中添加：

  java {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
  
  tasks.withType(JavaCompile) {
    options.compilerArgs += ['-release', '8']
    def jdkPath = System.getProperty('user.home') + (System.getProperty('os.name').toLowerCase().contains('win') ? '\\.jdks\\amazon-corretto-1.8.0_XXX\\bin\\javac.exe' : '/.jdks/amazon-corretto-1.8.0_XXX/bin/javac')
    options.fork = true
    options.forkOptions.executable = jdkPath
  }
  

这样即使IDE配置异常，构建工具也会强制使用指定JDK编译。

4. 锁定misc.xml的JDK配置 #

在.gitattributes中添加规则，避免IDE自动修改的配置被提交：

.idea/misc.xml merge=ours

Git会优先保留你的配置版本，防止多人协作时的配置冲突。

验证流程 #

1. 删除本地~/.jdks目录，执行git clean -fdx清理项目
2. 重新克隆项目并打开IntelliJ
3. 手动下载Corretto 1.8并指定路径，或按IDE提示手动选择已下载的JDK
4. 检查misc.xml、compiler.xml是否保持1.8配置，构建工具能否正常编译

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