统一多模块项目版本的核心是将 version 集中声明于 libs.versions.toml 并通过 settings.gradle.kts 启用 VERSION_CATALOGS，再在根 build.gradle.kts 中用 subprojects { version = libs.versions.project.get() } 全局赋值，Android 模块还需在 android.defaultConfig 中显式同步 versionName/versionCode。
多模块项目里统一项目版本，核心是把 version 这个值从各个 build.gradle.kts 里抽出来，集中声明、全局生效。不这么做，每个模块自己写 version = "1.2.0"，改一次就得开十几个文件，还容易漏。
settings.gradle.kts 里用 versionCatalog 定义 projectVersion
Gradle 7.0+ 的 libs.versions.toml 不只管依赖，也能管项目自身版本。在 gradle/libs.versions.toml 中加一段：
[versions] project = "1.2.0"
然后在 settings.gradle.kts 里确保已启用版本目录：
enableFeaturePreview("VERSION_CATALOGS")
enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")
这样所有模块就能通过 libs.versions.project.get() 拿到统一的版本号，而不是各自硬编码。
subprojects { } 块中强制覆盖 version 属性
即使用了版本目录，模块的 version 属性默认还是空或继承自父工程（而根工程没设）。必须显式赋值：
- 在根项目的
build.gradle.kts里写subprojects { version = libs.versions.project.get() } - 如果用了 Kotlin Multiplatform 或 Android Library 模块，
version是Project对象的属性，不是Extension，所以不能放在android { }或kotlin { }里设 - Android App 模块的
versionName和versionCode需单独同步，它们不自动读project.version
Android 模块的 versionName/versionCode 怎么同步
Android 的 versionName 和 versionCode 在 android { defaultConfig { } } 里，和 Gradle 的 project.version 是两套系统。常见错误是只改了后者，忘了前者。
推荐做法是在 android { defaultConfig { } } 中直接引用：
versionName = project.version.toString()
versionCode = (project.version.toString().replace(".", "").toIntOrNull() ?: 1) * 10
或者更稳妥地从 libs.versions.project.get() 解析语义化版本，提取主次修订号计算 versionCode。注意：versionCode 必须是整数且单调递增，不能直接用字符串。
别忽略 gradle.properties 里的 version 冲突
有些老项目还在 gradle.properties 里定义 version=1.2.0，然后在 build.gradle.kts 里用 project.findProperty("version") 读取。这会和 libs.versions.project 并存，造成混淆。
建议彻底移除 gradle.properties 中的 version，只保留 org.gradle.jvmargs 或 android.useAndroidX 这类构建参数。否则 IDE 可能缓存旧值，sync 后看到的 project.version 不是你以为的那个。
真正麻烦的点不在怎么写，而在“谁在什么时候读哪个 version”。Android 构建、Maven Publish、CI 打包脚本可能各自取值路径不同，上线前务必验证最终生成的 aar/apk 的 Manifest 和 POM 文件里写的版本是否一致。
