Kola 工具链

理解 ApiHug 中 Kola 的 SDK、IDEA 插件、Gradle 任务与 DSL 文件如何协同工作。

本页说明

这一页讲的是 Kola 背后的工具链，而不只是 DSL 语法本身。

当你需要理解 Kola 能否稳定运行依赖哪些环节时，请先看这一页。

Kola 依赖四层能力共同配合：

只要其中任何一层版本严重失配，Kola 工作流通常就会很快变得不稳定。

服务、请求、响应、实体以及相关元数据都从 proto 驱动模块开始。

Kola 最适合与拥有 API 契约的模块一起演进，而不是独立散落在另一个无上下文的测试目录里。

常见执行入口：

Terminal

./gradlew.bat {proto_module}:kolaTest --stacktrace

这也是为什么 Kola 应该被视为一条完整工具链，而不只是一个单独 DSL 特性。

插件主要负责：

插件不是执行引擎。它解决的是“写得更快”，而不是“跑得起来”。

Gradle 负责：

如果构建层没有正确暴露 Kola 任务，单独写好 DSL 文件仍然无法形成稳定流程。

当 SDK、插件、proto 模块与 Gradle 任务保持一致时，Kola 才会真正成为团队可复用、可持续维护的契约测试工作流，而不是某个人本地临时可跑的一套脚本。