本文介绍如何通过 GoConvey 的 -depth=0 参数精确控制测试执行范围，使其仅运行当前目录下的 main 包（或当前工作目录的单个包）测试，避免默认的递归扫描行为。
本文介绍如何通过 goconvey 的 `-depth=0` 参数精确控制测试执行范围，使其仅运行当前目录下的 `main` 包（或当前工作目录的单个包）测试，避免默认的递归扫描行为。
在使用 GoConvey 进行 Go 项目测试时，一个常见痛点是：它默认以递归方式扫描整个模块树（等效于 go test ./...），导致非预期的子包测试被一并执行——尤其当项目结构包含多个子目录（如 cmd/, internal/, pkg/）时，这不仅拖慢反馈速度，还可能因依赖冲突或初始化副作用引发误报。
而 go test 命令本身天然支持精准控制：
- go test -v：仅运行当前目录下的测试（即当前包，通常是 main 或 .）；
- go test -v ./...：递归运行所有子目录下的测试；
- go test -v ./cmd/...：仅递归运行 cmd/ 下的测试。
但 GoConvey 并不直接复用当前终端的 go test 调用上下文，而是自行遍历路径。此时，-depth 参数是官方推荐的轻量级解决方案：
# 仅扫描当前工作目录（即只运行当前包的测试，等效于 go test -v） $ goconvey -depth=0 # 对比：默认行为（depth=1，会进入一级子目录） $ goconvey -depth=1 # 查看完整参数说明 $ goconvey -help
✅ 关键说明：-depth=0 表示“深度为 0”，即不进入任何子目录，严格限定在 .（当前目录）下发现并运行测试。这对 main 包尤为实用——只要你在 main 所在目录（例如 ./cmd/myapp/）启动 GoConvey，它就只会加载该目录下的 _test.go 文件，完全规避跨包干扰。
你也可以将该配置持久化，避免每次手动输入：
- 创建 .convey 配置文件（位于项目根目录或当前目录）：
{ "depth": 0, "port": 8080, "poll": 500 } - 启动时 GoConvey 会自动读取该配置，实现开箱即用的单包聚焦模式。
⚠️ 注意事项：
- 确保当前工作目录确实是目标 main 包所在路径（go list -f '{{.Name}}' . 应输出 main）；
- 若使用 Go modules，请确认 go.mod 已正确初始化，否则 GoConvey 可能无法准确解析包边界；
- -depth=0 不影响 go test 的其他行为（如 -race、-cover），你仍可在 .convey 中通过 "args" 字段追加，例如："args": ["-race", "-cover"]。
总结：无需修改代码、无需编写复杂脚本，一条 goconvey -depth=0 即可让 GoConvey 回归“单包专注”本质——这既是 Go 工具链哲学的体现，也是提升测试可靠性和开发体验的关键实践。
