如何解决 Glide 安装时报错 “$GOPATH is not set”-Golang-PHP中文网

如何解决 Glide 安装时报错 “$GOPATH is not set”

Glide 报错 [ERROR] $GOPATH is not set 通常并非因 GOPATH 未配置，而是因使用 sudo 导致环境变量丢失；正确做法是避免 sudo，确保当前用户对 $GOPATH 具有完整读写执行权限。

glide 报错 `[error] $gopath is not set` 通常并非因 gopath 未配置，而是因使用 `sudo` 导致环境变量丢失；正确做法是避免 sudo，确保当前用户对 `$gopath` 具有完整读写执行权限。

当你在 macOS 或 Linux 系统中执行 sudo glide install 时，系统会以 root 用户身份启动一个全新的 shell 环境——该环境默认不继承当前用户的 GOPATH、GOROOT 等环境变量（即使你已在 ~/.zshrc 或 ~/.bash_profile 中正确导出）。因此，尽管 echo $GOPATH 显示 /Users/yako/go，sudo echo $GOPATH 却为空，sudo glide install 自然报错。

✅ 正确操作步骤如下：

确认 GOPATH 已正确设置且权限合规
运行以下命令验证：
```
go env GOPATH
ls -ld "$GOPATH"
```
输出应类似：
```
/Users/yako/go
drwxr-xr-x  5 yako  staff  160 May 20 10:30 /Users/yako/go
```
✅ 关键要求：当前用户（yako）必须对 $GOPATH 目录拥有 读（r）、写（w）、执行（x）权限（x 对目录意味着可进入和遍历）。若权限不足，运行：
```
chmod 755 "$GOPATH"
```
绝对避免使用 sudo 运行 glide
Glide 仅需向 $GOPATH/src 和 $GOPATH/vendor 写入依赖，无需 root 权限。直接执行：
```
cd $GOPATH/src/github.com/btcsuite/btcd
glide install
```
若提示 command not found: glide，说明 glide 二进制未在 PATH 中——它默认安装在 $GOPATH/bin，请确保已将该路径加入 PATH：
```
echo 'export PATH="$GOPATH/bin:$PATH"' >> ~/.zshrc  # 或 ~/.bash_profile
source ~/.zshrc
```
（可选）临时为 sudo 传递 GOPATH（不推荐）
仅作调试参考，切勿用于日常开发：
```
sudo GOPATH="$GOPATH" glide install
```
但此举违背最小权限原则，且可能引发后续构建权限混乱（如生成的 vendor/ 目录属 root，导致后续 go build 失败）。

⚠️ 注意事项：

btcd 官方文档曾建议 sudo glide install，这是过时或不严谨的写法；现代 Go 项目（包括新版 btcd）已转向 Go Modules，Glide 已停止维护（Last release: 2019），建议优先使用 go mod tidy 替代。
若你正使用较新版本的 btcd（v0.23+），请直接运行 go mod download 而非 glide install，无需额外工具链。

总结：环境变量失效源于 sudo 的隔离机制，而非配置错误。坚持“非必要不加 sudo”，确保 $GOPATH 权限合理、$GOPATH/bin 在 PATH 中，即可彻底规避该问题。