在使用godep管理go项目依赖时，若测试包（如testify）位于内层子包，标准的`godep save`命令可能无法捕获这些测试依赖。本文将详细指导读者如何通过使用`godep save ./...`命令，递归扫描项目所有子包，确保全面保存包括测试依赖在内的所有外部依赖，从而避免因依赖缺失导致的构建或测试问题。
理解Godep与依赖管理
Godep是一个Go语言的依赖管理工具，它通过将项目依赖的精确版本保存到项目的vendor目录和Godeps.json文件中，来确保项目构建的可复现性。当Go Modules成为官方推荐的依赖管理方案之前，Godep在许多Go项目中扮演了重要的角色。它的核心功能是锁定项目所依赖的外部包及其版本，以防止未来依赖更新可能带来的不兼容性。
Godep在测试依赖管理中遇到的挑战
许多Go项目会引入专门的测试库，例如github.com/stretchr/testify，来编写更强大、更富有表现力的单元测试和集成测试。然而，开发者在使用godep save命令时，可能会发现Godeps.json文件中并未包含这些测试依赖。
出现这种情况的常见原因在于：
- 默认行为限制： godep save在不指定路径的情况下，通常只扫描当前目录下的Go源文件及其直接依赖。
- 内层包测试： 如果项目的测试文件（及其依赖）存在于当前目录的子包中，例如myproject/pkg/subpkg/subpkg_test.go，那么默认的godep save命令可能无法触达这些子包，进而遗漏它们的测试依赖。
相比之下，go get -t命令能够正确识别并安装测试依赖，因为它被设计为安装构建和测试所需的所有依赖。但godep save的目标是记录和锁定这些依赖，其扫描范围需要更明确的指示。
解决方案：使用godep save ./...
解决Godep无法保存内层包测试依赖问题的关键在于扩展其扫描范围。godep save ./...命令是这个问题的标准解决方案。
godep save ./... 的工作原理
./...是一个Go命令行工具中常用的模式，它表示递归地处理当前目录及其所有子目录中的Go包。当与godep save结合使用时，它会指示Godep：
- 递归扫描： 遍历项目根目录下的所有子包。
- 识别所有依赖： 不仅识别主应用程序代码的依赖，还会识别所有测试文件（_test.go）中导入的依赖。
- 统一保存： 将所有发现的依赖（包括测试依赖）的精确版本信息记录到Godeps.json文件，并将这些依赖的源代码复制到项目的vendor目录中。
示例代码
假设你的项目结构如下：
myproject/
├── main.go
├── go.mod (如果存在，但使用godep通常是老项目)
├── go.sum
├── pkg/
│ └── util/
│ ├── util.go
│ └── util_test.go (这里使用了testify)
└── Godeps/
└── Godeps.json如果pkg/util/util_test.go文件导入了github.com/stretchr/testify/assert，而你只运行了godep save，那么testify可能不会被包含在Godeps.json中。
正确的操作步骤是：
-
导航到项目根目录：
cd /path/to/your/myproject
-
执行递归保存命令：
godep save ./...
执行此命令后，Godeps.json文件将更新，其中会包含github.com/stretchr/testify及其所有必要的依赖。同时，这些依赖的源代码也会被复制到vendor目录中。
验证结果
命令执行完毕后，务必检查Godeps.json文件，确认testify或其他预期的测试依赖已被正确列出。
// Godeps/Godeps.json 示例片段
{
"ImportPath": "myproject",
"GoVersion": "go1.x",
"Deps": [
{
"ImportPath": "github.com/davecgh/go-spew/spew",
"Comment": "v1.1.1-go.1.0-beta.20191028165004-92769941a13b",
"Rev": "92769941a13b0a70f1a92a543666b6c77d5497b7"
},
{
"ImportPath": "github.com/pmezard/go-difflib/difflib",
"Comment": "v1.0.0-go.1.0-beta.20191028165004-92769941a13b",
"Rev": "79276fa8d552365e06465780c23674064979c354"
},
{
"ImportPath": "github.com/stretchr/testify/assert",
"Comment": "v1.8.4",
"Rev": "0a65196d00438a011783401736141a069415849b"
},
// ... 其他依赖
]
}请注意，testify通常会引入go-spew和go-difflib等辅助依赖，它们也会一并被记录。
注意事项与最佳实践
- 始终使用./...： 除非你非常确定项目结构简单且所有依赖都在根包中，否则建议在运行godep save时始终带上./...，以确保所有依赖（包括测试依赖）都被完整捕获。
- Go Modules的替代： 值得注意的是，Godep是一个较早期的Go依赖管理工具，目前Go官方推荐使用Go Modules进行依赖管理。如果你的项目允许，强烈建议升级到Go Modules，它提供了更强大、更灵活且内置的依赖管理能力，且对测试依赖的处理更为直观。
- 版本控制： Godeps/Godeps.json文件和vendor目录都应该被纳入版本控制（例如Git），以确保团队成员和CI/CD系统能够基于相同的依赖环境进行构建。
- 清理与重构： 如果遇到依赖问题，可以尝试删除vendor目录和Godeps.json文件，然后重新运行godep save ./...来重建依赖。
总结
在使用Godep管理Go项目依赖时，为了确保所有测试依赖（尤其是位于子包中的依赖）都被正确捕获和锁定，关键在于使用godep save ./...命令。这个命令通过递归扫描项目的所有子包，能够全面识别并保存包括测试依赖在内的所有外部依赖，从而保证项目构建和测试环境的一致性和可复现性。尽管Go Modules已成为主流，对于仍在使用Godep的旧项目，掌握这一技巧是高效进行依赖管理的重要一环。
