本文详解在godep工具约束下，如何合理组织未发布（非git托管）的本地自定义包，避免“package not found”和“not using a known version control system”错误，兼顾可部署性与开发简洁性。
本文详解在godep工具约束下，如何合理组织未发布（非git托管）的本地自定义包，避免“package not found”和“not using a known version control system”错误，兼顾可部署性与开发简洁性。
在Go早期生态（Go 1.5–1.10时代），godep 是主流依赖管理工具，其设计哲学严格遵循“所有依赖必须可版本化、可复现”的原则：它要求每个被 import 的包路径（如 github.com/u-mulder/package_one）必须存在于 $GOPATH/src/ 下，且该目录需为有效版本控制系统（如 Git）工作区。这导致一个常见困境：开发者希望将私有、未托管的工具包（如内部加密、配置解析模块）纳入项目，又不愿为其单独建仓库、提交代码——而这恰恰与 godep 的底层机制冲突。
✅ 正确路径：回归 GOPATH + 轻量版 Git 初始化（推荐）
godep 不接受 vendor/ 中的包作为“源依赖”，因为它只扫描 $GOPATH/src 并通过 git describe 或 hg id 提取版本信息。因此，本地包必须置于 $GOPATH/src，且需最小化 Git 支持：
# 假设 GOPATH=/home/user/go mkdir -p $GOPATH/src/github.com/u-mulder/package_one cp /path/to/your/package_one.go $GOPATH/src/github.com/u-mulder/package_one/ # 初始化空 Git 仓库（无需远程、无需提交历史） cd $GOPATH/src/github.com/u-mulder/package_one git init git add package_one.go git commit -m "initial local package" # 仅一次提交，无远程关联
重复上述步骤为 package_two 创建独立 Git 仓库。此时运行：
cd /path/to/project_name godep save ./...
godep 将成功识别并锁定这两个包的当前 commit hash（如 a1b2c3d），生成 Godeps/Godeps.json 中包含：
{
"ImportPath": "github.com/u-mulder/package_one",
"Rev": "a1b2c3d..."
}
⚠️ 注意：
godep save默认忽略vendor/目录——它只从$GOPATH/src构建依赖图。因此，请勿将本地包预先放入vendor/；vendor/应仅由godep restore在部署时自动填充。
❌ 不可行方案辨析
直接放
vendor/中并import "./vendor/..."
Go 编译器禁止相对路径导入（import "./vendor/..."报错cannot import relative path），且godep完全不处理此类路径。用
godep save -r（recursive）跳过版本检查
该标志仅影响子模块递归行为，无法绕过“目录必须是 VCS 工作区”的硬性校验，仍会报not using a known version control system。删除
vendor/后godep save，再手动拷回
如答案所述，此法破坏依赖一致性：godep restore会覆盖手动添加的内容，导致 Heroku 部署失败或本地/线上行为不一致。
? 现代替代建议：迁移到 Go Modules（强烈推荐）
godep 已于 Go 1.11+ 被官方模块（Go Modules）取代。若项目允许升级，应立即迁移：
# 在项目根目录执行（Go ≥1.11） go mod init github.com/u-mulder/project_name go mod edit -replace github.com/u-mulder/package_one=../local-packages/package_one go mod tidy
此时 package_one 可存于任意本地路径（如 ../local-packages/package_one），无需 Git，go build 和 heroku buildpacks:set https://github.com/heroku/heroku-buildpack-go 均能正确解析。go mod vendor 亦可生成兼容的 vendor/ 目录。
总结
| 方案 | 是否满足 godep
|
是否需 Git | 是否推荐 |
|---|---|---|---|
$GOPATH/src + 空 Git 仓库 |
✅ 完全支持 | ✅（最低限度） | ⚠️ 临时兼容方案 |
vendor/ 中手动放置 |
❌ 编译失败 | ❌ | ❌ 绝对避免 |
| 迁移至 Go Modules | ✅（原生支持） | ❌ | ✅✅✅ 长期首选 |
核心原则：godep 的本质是“基于 VCS 的依赖快照工具”，而非通用包管理器。与其对抗其设计约束，不如拥抱 Go Modules——它原生支持 replace、本地路径、伪版本号，彻底解耦“代码存放位置”与“导入路径”，让私有包真正“即写即用”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
