IntelliJ Kotlin Gradle添加模块时Parent选项的差异及适用场景咨询

嘿，作为经常和Gradle（Kotlin项目默认的构建工具）打交道的开发者，我来给你把这个问题掰扯清楚～

首先得补个关键背景：IntelliJ里的这个Parent选项，本质对应Gradle的多项目构建机制——简单说就是把多个模块聚合到一个父项目下共享构建配置，或者让模块成为完全独立的项目。

一、两者的核心区别 #

1. 项目结构与构建关联 #

• 选择父项目作为Parent：
  这个模块会成为父项目的子模块，Gradle会在父项目的settings.gradle.kts里自动添加include(":你的模块名")，把它纳入整个多项目构建体系。子模块和父项目共享构建上下文，比如父项目的仓库配置、插件版本管理都会被继承。
• 选择None：
  这个模块会变成独立的根项目，拥有自己独立的settings.gradle.kts和构建配置文件，和原父项目没有任何构建层面的关联——相当于在当前目录下新建了一个完全独立的Kotlin项目。

2. 构建配置的差异 #

这也是你遇到报错的核心原因：

• 选Parent的子模块：
  可以省略大量重复配置，比如不用再写repositories（父项目已经配置了mavenCentral等仓库），不用给插件加版本号（父项目通常会通过plugins { id("org.jetbrains.kotlin.jvm") version "1.3.72" apply false }统一管理所有子模块的插件版本）。你之前选Parent时构建正常，就是因为子模块继承了父项目的插件版本和仓库配置，只需要声明插件ID就行。
• 选None的独立模块：
  必须自己配置完整的构建要素，包括仓库地址、插件版本、依赖等。你遇到的两个报错：
  • 第一个Error resolving plugin... must not include a version：是因为这个独立模块和父项目在同一个IntelliJ窗口里，Gradle上下文冲突——父项目已经把kotlin插件加到classpath了，独立模块再指定版本就重复了。
  • 第二个Plugin was not found：是因为你移除版本号后，独立模块自己没配置仓库地址，Gradle找不到插件来源。

二、何时该选哪种方式 #

优先选Parent（作为子模块）的场景 #

• 这个模块是当前项目的一部分，比如你把项目拆成domain、data、ui等分层模块，需要统一管理依赖版本、构建插件。
• 希望减少重复配置，以后升级插件或依赖版本时，只需要修改父项目的配置就能同步到所有子模块。

选None（作为独立项目）的场景 #

• 这个模块是完全独立的，比如你要做一个可复用的工具库，以后可能单独发布给其他项目使用，不需要和原项目共享任何构建规则。
• 这个模块有特殊的构建需求，比如需要用不同版本的Kotlin插件、不同的仓库地址，和原项目的配置冲突。

给你解决报错的小技巧 #

如果确实需要创建独立模块（选None），记得在模块的build.gradle.kts里补全完整配置：

plugins {
    kotlin("jvm") version "1.3.72"
}

repositories {
    mavenCentral() // 必须添加仓库，否则Gradle找不到插件
}

dependencies {
    implementation(kotlin("stdlib-jdk8"))
}

这样就能正常构建了～

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