本文详解 Glide 在 Go 项目中的正确使用流程，重点解决 go build 忽略 vendor/ 目录导致“cannot find package”错误的核心原因——项目路径未位于 $GOPATH/src 下，并提供跨平台可复用的解决方案。
本文详解 glide 在 go 项目中的正确使用流程，重点解决 `go build` 忽略 `vendor/` 目录导致“cannot find package”错误的核心原因——项目路径未位于 `$gopath/src` 下，并提供跨平台可复用的解决方案。
Glide 是 Go 1.5–1.11 时代主流的第三方依赖管理工具，它通过生成 glide.yaml（声明式依赖配置）和 glide.lock（锁定精确版本与依赖树），将所有依赖自动下载并归档至项目根目录下的 vendor/ 文件夹中，从而实现可重现的构建。但一个极易被忽视的前提是：Go 工具链仅在项目源码位于 $GOPATH/src/ 子路径下时，才会启用 vendor 机制——即使你已使用 glide install 成功填充了 vendor/，若项目不在 $GOPATH/src 中，go build 仍会完全跳过该目录，直接向 $GOROOT/src 和 $GOPATH/src 搜索包，最终报错 cannot find package。
✅ 正确的项目结构前提
Glide 本身不改变 Go 的 vendor 查找逻辑。自 Go 1.6 起，vendor 支持已默认启用（无需设置 GO15VENDOREXPERIMENT=1），但其生效有严格路径要求：
$GOPATH/src/
└── github.com/yourname/yourproject/ ← 必须在此路径下！
├── glide.yaml
├── glide.lock
├── main.go
└── vendor/
└── github.com/...⚠️ 注意：
go build不接受任意路径下的vendor/。例如将项目克隆到/tmp/yourproject或~/projects/yourproject后执行go build，vendor 将被静默忽略——这正是提问者遇到的根本问题。
✅ 解决方案（三选一，推荐方案1）
方案1：软链接项目到 $GOPATH/src（推荐，无侵入、易回滚）
# 假设你的项目当前在 /home/user/myproject # 确保 $GOPATH 已设置（如 export GOPATH=$HOME/go） mkdir -p $GOPATH/src/github.com/yourname ln -sf /home/user/myproject $GOPATH/src/github.com/yourname/myproject # 进入标准路径后构建 cd $GOPATH/src/github.com/yourname/myproject go build -o ploop main.go # ✅ vendor 现在生效
方案2：直接克隆/移动项目到 $GOPATH/src
git clone https://github.com/yourname/myproject.git $GOPATH/src/github.com/yourname/myproject cd $GOPATH/src/github.com/yourname/myproject glide install go build -o ploop main.go
方案3：使用 go build -mod=vendor（⚠️ 仅限 Go 1.14+，且需 go.mod）
注：此为现代方案，但 Glide 项目通常无
go.mod。若强行添加，将与 Glide 冲突。因此不建议在纯 Glide 项目中混用模块模式。
✅ 验证 vendor 是否生效
运行以下命令确认 Go 正在读取 vendor：
go list -f '{{.Dir}}' github.com/urfave/cli
# ✅ 正确输出应为：/path/to/your/project/vendor/github.com/urfave/cli
# ❌ 错误输出为：/home/user/go/src/github.com/urfave/cli（说明 vendor 未命中）✅ 补充：Glide 常用命令速查
| 命令 | 说明 |
|---|---|
glide init |
扫描 import 语句，生成初始 glide.yaml
|
glide get github.com/urfave/cli |
安装单个包并写入 glide.yaml
|
glide up 或 glide update
|
根据 glide.yaml 更新依赖，生成/刷新 glide.lock
|
glide install |
仅根据 glide.lock 复现 vendor（CI/CD 构建推荐） |
? 提示：在 CI 环境中，应始终先
glide install（确保 vendor 精确一致），再go build；避免使用glide up，以防意外升级依赖。
⚠️ 重要注意事项
-
Glide 已归档：自 Go 1.11 引入官方模块（
go mod）后，Glide 于 2018 年正式停止维护（GitHub Archive Notice）。新项目请直接使用go mod；遗留 Glide 项目迁移可执行glide novendor && go mod init && go mod tidy。 -
代理与镜像：若遇
golang.org/x/...类包下载失败，务必配置镜像：glide mirror set https://golang.org/x/net https://github.com/golang/net --vcs git
-
Windows 权限问题：在 Windows 上执行
glide install报Access is denied，需修改winbug.go中的文件移动逻辑（替换move为xcopy /s/y），或以管理员身份运行终端。
遵循以上路径规范与操作流程，即可彻底解决 Glide vendor 被忽略的问题，确保构建环境一致性与可移植性。
