本文介绍如何通过 goconvey -depth=0 参数限制 goconvey 仅扫描并执行当前工作目录下的测试（即显式指定 main 包），避免默认递归行为导致的无关包测试干扰。
本文介绍如何通过 goconvey -depth=0 参数限制 goconvey 仅扫描并执行当前工作目录下的测试（即显式指定 main 包），避免默认递归行为导致的无关包测试干扰。
在 Go 项目开发中，尤其是采用单模块多子包结构时，常需对主程序（main 包）进行独立、快速的测试验证。虽然原生 go test 命令可通过 go test -v . 明确限定当前目录（即 main 包），但 GoConvey 默认以递归模式（等效于 ./...）自动发现并运行所有子目录下的测试，这不仅拖慢响应速度，还可能因依赖未初始化或环境差异引发误报。
幸运的是，GoConvey 提供了 -depth 控制参数，用于精确约束扫描深度：
$ goconvey -depth=0
该命令将 GoConvey 的包发现范围严格限制在当前工作目录（即 .），从而确保仅加载和运行当前目录下定义的 *_test.go 文件——这正是 main 包测试的标准位置（注意：main 包本身不可被导入，其测试文件必须与 main.go 同级且属于 main 包）。
✅ 关键说明：
- -depth=0 表示“不进入任何子目录”，等价于 go test .；
- -depth=1 将扫描当前目录及其直接子目录（即 ./... 的一级展开）；
- 默认行为等同于 -depth=-1（无限递归），与 go test ./... 一致。
你也可以结合其他常用选项提升调试效率：
# 启动 GoConvey 并仅监控当前目录，启用详细日志与实时重载 $ goconvey -depth=0 -debug=true -poll=500 # 若需自定义端口或禁用浏览器自动打开 $ goconvey -depth=0 -port=8081 -no-open
⚠️ 注意事项：
- 确保当前终端工作目录为含 main.go 和对应 *_test.go 的目录；
- main 包的测试函数必须声明 func TestXxx(t *testing.T) 且位于 package main 中（Go 允许 main 包含测试，但不可被外部导入）；
- 不建议在 goconvey.conf 配置文件中全局覆盖 -depth，应按需在启动命令中显式指定，以保持不同场景下的灵活性。
总结而言，-depth=0 是精准控制 GoConvey 测试范围最简洁、可靠的方式。它无需修改项目结构、不依赖 profile 配置文件，也规避了手动指定包路径（如 goconvey -pkg=.）可能带来的兼容性问题，是面向 main 包快速迭代测试的最佳实践。
