Go 1.5 引入 vendor 机制后，go build 和 go run 默认支持从项目根目录下的 vendor/ 解析依赖，但前提是项目必须位于 $GOPATH/src 下；否则 Go 工具链会忽略 vendor，导致“cannot find package”错误。
go 1.5 引入 vendor 机制后，`go build` 和 `go run` 默认支持从项目根目录下的 `vendor/` 解析依赖，但前提是项目必须位于 `$gopath/src` 下；否则 go 工具链会忽略 vendor，导致“cannot find package”错误。
Go 自 1.5 版本起正式支持 Vendor Directory Mechanism（vendor 目录机制），旨在实现可重现的依赖管理。然而，该机制并非“开箱即用”——它对项目路径有严格要求：只有当项目源码位于 $GOPATH/src 子目录下时，Go 工具链（如 go run、go build）才会自动识别并优先从 ./vendor 加载包；若项目置于 $GOPATH 外（例如直接放在 ~/projects/myapi），即使存在合法的 vendor/ 目录，Go 也会完全忽略它，并仅搜索 $GOROOT/src 和 $GOPATH/src。
✅ 正确的项目结构示例
确保你的项目遵循标准 Go 工作区布局：
$ echo $GOPATH /home/yowmamasita/.gvm/pkgsets/go1.7.1/global:/home/yowmamasita/goprojects # 推荐只设置一个 GOPATH（多路径易引发混淆），例如： export GOPATH=/home/yowmamasita/goprojects
然后将项目放入 $GOPATH/src 下：
$GOPATH/
└── src/
└── myapp/ # ← 项目根目录（必须在此层级）
├── main.go
├── glide.yaml
├── glide.lock
└── vendor/
└── github.com/
└── gin-gonic/
└── gin/ # ← vendor 内容由 glide install 自动生成
? 注意：
myapp是任意有意义的子目录名（如github.com/username/myapi更佳），但关键在于它必须是$GOPATH/src的直接子目录。
? 验证与调试步骤
-
检查当前路径是否在
$GOPATH/src内：pwd # 应输出类似 /home/yowmamasita/goprojects/src/myapp go list -f '{{.Dir}}' . # 若输出非 vendor-aware 路径，说明位置错误 -
确认 Go 版本与 vendor 支持（Go 1.5+ 均默认启用，无需额外标志）：
go version # 确保 ≥ 1.5（你使用 1.6.3/1.7.1 完全兼容）
-
重建 vendor（可选）：
cd $GOPATH/src/myapp glide install # 或 glide up，确保 vendor 同步正确
-
运行验证：
go run main.go # 此时应成功解析 vendor/github.com/gin-gonic/gin
⚠️ 常见误区与注意事项
- ❌ 不要将项目放在
$GOPATH根目录或bin/、pkg/下：Go 只扫描src/下的子目录。 - ❌ 避免
$GOPATH包含多个路径（如:/home/...）：Go 会按顺序查找，可能导致意外命中旧版本代码或忽略 vendor。 - ✅ 推荐单 GOPATH + 标准路径：
export GOPATH=$HOME/go是社区最佳实践。 - ✅ 现代替代方案：Go 1.11+ 引入模块（
go mod），彻底摆脱$GOPATH限制；若环境允许，建议升级并迁移至模块模式。
总结
vendor 机制的生效不依赖于任何命令行开关（如 -i 或 -v），而完全取决于项目物理路径是否符合 $GOPATH/src/<import-path></import-path> 规范。修复路径后，go run 将自动启用 vendor 解析，无需修改代码或配置。这是 Go 早期依赖管理的关键约定，理解并遵守它，是构建稳定 Go 项目的基石。
