本文详解 Go 1.6+ vendor 实验模式下常见路径错误：vendor 目录必须位于 $GOPATH/src/<import-path> 的父级目录中，而非随意放置；若项目未置于 src 子目录下，Go 工具链将完全忽略 vendor，导致 “cannot find package” 错误。
本文详解 go 1.6+ vendor 实验模式下常见路径错误：vendor 目录必须位于 `$gopath/src/
在 Go 1.6 引入 GO15VENDOREXPERIMENT=1（后于 1.7 默认启用）后，vendor 机制成为官方推荐的依赖隔离方案——但它的生效有严格的目录层级前提：vendor/ 目录必须嵌套在 $GOPATH/src/ 下的合法导入路径内，且仅对其父目录及子目录中的 .go 文件可见。
你当前的结构：
/project
/application ← ❌ 错误：这不是 $GOPATH/src 下的有效路径
main.go
/vendor/... ← vendor 被完全忽略！并设置了 GOPATH=/Users/me/project/application，这导致 Go 将整个 application/ 当作 GOPATH 根目录。于是工具链按规则查找：
- $GOROOT/src/...（标准库）
- $GOPATH/src/...（即 /Users/me/project/application/src/...）→ 但你的代码不在 src/ 下！
因此报错中出现：
/Users/me/project/application/src/github.com/facebookgo/grace/gracehttp (from $GOPATH)
——Go 在空的 src/ 子目录里徒劳搜索，而真正的 vendor/ 因位置非法被跳过。
✅ 正确做法：严格遵循 GOPATH 工作区约定
将项目移入 $GOPATH/src，并使用有意义的导入路径（如 github.com/username/application）：
# 1. 设置标准 GOPATH（推荐默认值，避免自定义陷阱） export GOPATH=$HOME/go mkdir -p $GOPATH/src/github.com/yourname/application # 2. 移动代码至此 mv /project/application/* $GOPATH/src/github.com/yourname/application/ # 3. vendor 目录现在应位于： $GOPATH/src/github.com/yourname/application/vendor/
此时运行 go build，Go 会自动识别同级 vendor/ 并优先从中解析 github.com/facebookgo/grace/gracehttp。
⚠️ 关键注意事项：
- 不要将 GOPATH 指向项目根目录（如 GOPATH=/path/to/app），这是最常见误操作。GOPATH 是工作区根，不是项目根。
- vendor/ 必须与 main.go 处于同一目录层级，且该目录必须是 $GOPATH/src/... 的子路径。
- 验证是否生效：执行 go list -f '{{.Dir}}' github.com/facebookgo/grace/gracehttp，输出应为 .../vendor/github.com/facebookgo/grace/gracehttp。
- Go 1.11+ 已全面转向 Go Modules，vendor 实验模式已废弃。新项目请直接使用 go mod vendor + GO111MODULE=on，无需依赖 GOPATH。
? 现代替代方案（推荐）：
彻底告别 GOPATH 依赖，启用模块化开发：
# 任意目录初始化模块（无需 GOPATH） cd /project/application go mod init github.com/yourname/application go mod vendor # 生成 vendor/ 目录 go build # 自动使用 vendor 中的包
此时 vendor/ 生效不再受 $GOPATH/src 约束，且兼容所有 Go 1.11+ 版本。
总结：vendor 不是“插件式”目录，而是 Go 工具链基于静态路径推导的语义特性。修复本质在于回归 GOPATH 规范结构，或更优地——迁移到 Go Modules，这是 Go 官方已确立的现代工程标准。
