文档

构建与测试配置

说明 Coroid 如何构建和测试您的项目,以及为何正确配置相关内容比任何其他设置都更为重要。

无法构建和测试项目的智能体,无法验证自身的工作成果。 后续的所有环节——质量门控、代码评审,以及对拉取请求的信任——都依赖于这些命令的正确性。

创建项目时,Coroid 会自动检测相关配置。查看它的检测结果。

Coroid 所需的配置

命令用途
安装在干净的工作区中恢复依赖项
构建确认项目能够成功编译
测试运行测试套件并查看结果

每个任务对应的工作区都是干净且可丢弃的,因此每条命令都必须能在没有任何缓存或预安装内容的新克隆环境中正常运行。

检测过程中常见的错误点

**单体仓库。**命令位于子目录中,或需要指定工作区过滤器。根目录下的命令可能存在,但执行结果却不符合预期。

**初始化步骤。**部分测试套件在运行前需要先执行代码生成、数据迁移或预构建测试用例等操作。检测工具只能识别测试命令,却会忽略其前置依赖。

**服务依赖项。**有些测试需要数据库、缓存或消息队列等服务处于运行状态。 如果测试套件默认假设localhost:5432已经启动,那么在干净的工作区中测试就会失败。

**环境变量。**部分测试套件会从.env中读取配置信息,而该文件并不在代码库中。

配置错误的表现

表现为任务在验证阶段因与变更无关的原因而失败——无论请求内容是什么,每个任务都在同一阶段出现相同故障。

如果最先出现的故障发生在编写任何代码之前,那几乎肯定是构建命令的问题;如果故障出现在变更之后,通常是测试命令或测试所依赖的内容存在问题。

容器

如果项目支持容器化,Coroid 可将容器作为执行环境——这样就能一次性解决服务依赖和环境差异问题,因为容器本身已包含了相关配置。

如果您有能正常运行测试的 Dockerfile 或 Compose 文件,这通常是您可获得的最可靠的配置方案。

语言支持

智能体可支持任何编程语言,但 Coroid 能自行验证的程度存在差异——尤其是语义导航方面。详情请参阅语言支持与智能体运行环境了解工作区中安装了哪些组件,以及哪些语言配备了语言服务器。

正确配置这些命令的重要性远超所选编程语言。在支持程度较低的语言中,正确的构建和测试组合,也比在支持程度较高的语言中配置错误的情况要好。