版本目录有助于高效管理依赖项，但有时也会出现错误。

本指南提供了 Gradle 中常见版本目录问题的快速解决方案。

1. 修复访问器名称冲突

错误：版本目录中有两个别名映射到同一个访问器。

someAlias = { module="org.sample:lib", version="1.0" }
some-alias = { module="org.sample:other-lib", version="2.0" }

解决方案：选择不同的别名以避免冲突。

firstAlias = { module="org.sample:lib", version="1.0" }
secondAlias = { module="org.sample:other-lib", version="2.0" }

2. 处理目录中条目过多

错误：目录超出 JVM 文件格式施加的 32,000 条目限制。

解决方案：将目录拆分成多个较小的目录。

3. 解决保留的别名名称

错误：别名使用了 versions、bundles、plugins、extensions 或 class 等保留名称。

versions = { module="org.sample:lib", version="1.0" }

解决方案：选择不同的别名名称。

sampleLib = { module="org.sample:lib", version="1.0" }

4. 修复未定义的版本引用

错误：库引用了目录中不存在的版本。

[libraries]
myLib = { module="org.sample:lib", version.ref="undefinedVersion" }

解决方案：更正引用，或在目录中声明缺失的版本。

[versions]
definedVersion = "1.0"

[libraries]
myLib = { module="org.sample:lib", version.ref="definedVersion" }

5. 修复未定义的别名引用

错误：Bundle 引用了目录中不存在的库。

[bundles]
myBundle = ["existingLib", "undefinedLib"]

解决方案：确保在目录中定义了该库，或将其从 Bundle 中移除。

[bundles]
myBundle = ["existingLib"]

6. 更正无效的依赖表示法

错误：别名的依赖表示法不正确。

解决方案：使用正确的语法

library("some-alias", "com.mycompany:some-lib:1.1").withoutVersion()
[libraries]
some-alias = { module="com.mycompany:some-lib", version="1.1" }

7. 修复不支持的目录文件格式

错误：使用了无效的目录文件格式（例如 .txt）。

解决方案：使用 TOML 文件或 Settings API。

8. 处理缺失的目录文件

错误：指定的目录文件不存在。

解决方案：在尝试导入之前，确保文件存在。

9. 更正无效的别名或 Bundle 表示法

错误：别名名称与要求的格式 ([a-z]([a-zA-Z0-9_.\-])) 不匹配。

Alias! = { module="org.sample:lib", version="1.0" }

解决方案：使用有效的别名名称，例如 some-alias。

valid-alias = { module="org.sample:lib", version="1.0" }

10. 修复 TOML 中无效的模块表示法

错误：版本目录中 module 表示法不正确。

解决方案：使用正确的格式

[libraries]
groovy = { module="org.codehaus.groovy:groovy", version="3.0.5" }

11. 解决无效的 TOML 语法

错误：TOML 文件中存在语法或文法问题。

解决方案：确保键和结构正确

some-alias = { group="my-lib", name="1.0" }

12. 处理不支持的 TOML 文件版本

错误：目录文件使用了您的 Gradle 安装版本不支持的版本。

解决方案：将 Gradle 升级到新版本。

13. 修复无效的插件表示法

错误：插件别名表示法未将插件 ID 与版本分开。

解决方案：使用正确的格式：plugin.id:version。

[plugins]
spring-boot = { id="org.springframework.boot", version="2.5.2" }

14. 解决未完成的别名

错误：创建了别名但未在目录中注册。

解决方案：调用 .version() 或 .withoutVersion() 来完成别名。

library("some-alias", "org.sample:lib").version("1.0")

15. 修复多次导入调用

错误：导入语句被多次调用。

解决方案：确保每个版本目录只有一个导入调用。

16. 处理缺失的导入文件

错误：导入语句引用了不存在的文件。

解决方案：确保导入前指定的文件可用。

17. 修复导入文件过多

错误：导入语句引用了多个文件。

解决方案：确保导入时只指定一个文件。