本文介绍如何通过 goconvey -depth=0 精确控制 goconvey 仅扫描并运行当前工作目录（即 main 包所在目录）下的测试，避免默认递归行为误执行子包测试。
本文介绍如何通过 goconvey -depth=0 精确控制 goconvey 仅扫描并运行当前工作目录（即 main 包所在目录）下的测试，避免默认递归行为误执行子包测试。
在 Go 项目开发中，当项目结构包含多个子包（如 cmd/、internal/、pkg/）时，使用 GoConvey 启动 Web 测试界面（goconvey）默认会递归扫描当前目录及其所有子目录，自动发现并加载所有 *_test.go 文件。这虽便于全局测试，但在聚焦调试主程序（main package）时往往造成干扰——例如，你仅修改了 main.go 及其配套测试，却因子包中存在失败测试或耗时初始化逻辑，导致 GoConvey 界面持续报错或响应迟缓。
解决此问题最直接、可靠的方式是利用 GoConvey 内置的 -depth 参数：
goconvey -depth=0
该参数指定扫描深度：
- -depth=0 → 仅扫描当前工作目录（即执行命令时所在的路径），等效于 go test .；
- -depth=1 → 扫描当前目录 + 一级子目录；
- 默认（无参数）→ 无限递归（等效于 go test ./...）。
✅ 典型使用场景示例：
假设你的项目结构如下：
myapp/ ├── main.go ├── main_test.go ├── cmd/ │ └── server/ │ ├── server.go │ └── server_test.go └── go.mod
在 myapp/ 目录下执行：
# ✅ 仅运行 main.go 对应的测试（main_test.go），忽略 cmd/ 下所有测试 goconvey -depth=0 # ❌ 默认行为：递归扫描，将同时加载 main_test.go 和 cmd/server/server_test.go goconvey
⚠️ 注意事项：
- -depth 控制的是 GoConvey 的文件发现范围，不影响底层 go test 命令本身的包解析逻辑；
- 若需进一步定制（如固定传参给 go test），可配合 Profiles 功能，在 .convey.json 或 convey.yaml 中声明："go test -v ."，但 -depth=0 更轻量、无需配置文件；
- 确保当前工作目录确实是 main 包根目录（即包含 package main 和 go test 可识别的测试文件），否则可能提示 “no tests to run”。
? 总结：当需要专注 main 包测试时，优先使用 goconvey -depth=0 —— 它简洁、明确、零配置，是 GoConvey 提供的官方推荐方式，能有效隔离测试作用域，提升本地开发与调试效率。
