Go 1.6+ 的 vendor 实验性功能并非独立工作区，而是严格依赖 $GOPATH/src 目录结构；若 vendor 目录未置于 src 子路径下，Go 工具链将完全忽略它，导致 “cannot find package” 错误。

go 1.6+ 的 vendor 实验性功能并非独立工作区，而是严格依赖 `$gopath/src` 目录结构；若 vendor 目录未置于 `src` 子路径下，go 工具链将完全忽略它，导致 “cannot find package” 错误。

在 macOS 上使用 Go 1.6.2（及后续支持 vendor experiment 的版本）时，go vendor 机制看似启用（GO15VENDOREXPERIMENT=1），却始终无法识别 vendor/ 中的依赖包——这并非环境变量配置错误或安装残留所致，而是对 vendor 目录位置的根本性误解。

✅ vendor 的正确位置：必须嵌套于 $GOPATH/src/ 下

Go 的 vendor 机制设计原则是：vendor 目录仅对其父目录及其子树中的 .go 文件生效，且整个代码树（含 vendor）必须位于 $GOPATH/src 内部。你当前的目录结构：

/project
    /application
        main.go
        /vendor  ← ❌ 错误：不在 $GOPATH/src 下
            /github.com/...

且 GOPATH="/Users/me/project/application" —— 这意味着 Go 将 $GOPATH/src 解析为 /Users/me/project/application/src，而你的 main.go 和 vendor/ 都在 application/ 根目录，完全脱离 src/ 层级，因此 vendor 被彻底忽略。

✅ 正确结构应为：

# 假设 GOPATH=/Users/me/go（推荐标准路径）
/Users/me/go/
├── src/
│   └── myapp/                 # 项目根目录（对应 import path）
│       ├── main.go
│       ├── other.go
│       └── vendor/            # ✅ vendor 必须在此层级或其子目录下
│           └── github.com/
│               └── facebookgo/
│                   └── grace/
│                       └── gracehttp/

此时运行 go build，Go 会自动从 myapp/vendor/github.com/facebookgo/grace/gracehttp 加载包。

? 快速修复步骤（macOS 终端执行）

1. 重设标准 GOPATH（避免路径混乱）：

   echo 'export GOPATH=$HOME/go' >> ~/.zshrc
   echo 'export PATH=$PATH:$GOPATH/bin:/usr/local/go/bin' >> ~/.zshrc
   source ~/.zshrc
   mkdir -p $GOPATH/{src,bin,pkg}

2. 迁移项目到 $GOPATH/src：

   

   macOS Automator Services

   部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

   下载

   # 创建标准项目路径
   mkdir -p $GOPATH/src/myapp
   # 复制源码（保留 vendor）
   cp -r /project/application/* $GOPATH/src/myapp/
   # 确保 vendor 在 $GOPATH/src/myapp/vendor/
   ls $GOPATH/src/myapp/vendor/github.com/facebookgo/grace/gracehttp

3. 验证 vendor 生效：

   cd $GOPATH/src/myapp
   go build -v  # 应显示 "vendor/github.com/..." 而非报错

⚠️ 关键注意事项

• GO15VENDOREXPERIMENT=1 已过时：Go 1.11+ 默认启用模块（go mod），vendor 机制已被 go mod vendor 取代。若非维护旧项目，强烈建议升级至 Go 1.16+ 并使用模块化管理：

  cd $GOPATH/src/myapp
  go mod init myapp          # 初始化模块
  go mod tidy                # 自动下载依赖并生成 go.sum
  go mod vendor              # 导出 vendor 目录（可选）

• 不要用 sudo go get：sudo 会清空用户环境变量（包括 GOPATH），导致 vendor 或模块路径失效。所有 go get/go install 均应以普通用户执行。

• 检查 go env 输出：务必确认 GOPATH 和 GOROOT 路径真实存在且权限正常：

  go env GOPATH GOROOT
  ls -la $(go env GOPATH)/src

? 提示：现代 Go 开发中，GOPATH 仅用于存放 go install 的工具（如 gopls），项目本身无需置于 src/ 下。启用模块后，任意目录均可 go mod init，vendor 成为可选导出项，彻底摆脱路径束缚。

通过修正 vendor 的物理位置并拥抱 Go Modules，你不仅能解决当前问题，更能构建符合 Go 社区最佳实践的可持续开发环境。