Go命令找不到的根本原因是PATH未正确配置或shell配置未生效；需确认Go安装路径、将对应bin目录加入PATH，并source配置文件使更改生效。
Go 二进制安装后 go 命令找不到
这不是 PATH 没配好，就是 shell 配置没生效。Linux/macOS 下装完 Go 后，go 命令报 “command not found”，基本是 PATH 没加进当前 shell 环境。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 确认 Go 安装路径：通常为
/usr/local/go（源码安装）或/usr/bin/go（包管理器安装），用which go或ls /usr/local/go/bin/go验证 - 检查
PATH是否包含/usr/local/go/bin：运行echo $PATH，若无，需追加 - 修改对应 shell 配置文件：
~/.bashrc（bash）、~/.zshrc（zsh），添加export PATH=$PATH:/usr/local/go/bin - 执行
source ~/.zshrc（或source ~/.bashrc）立即生效，别忘了重开终端再测
Go module 初始化失败：提示 go: modules disabled by GO111MODULE=off
这是 Go 1.13+ 默认启用 module，但环境变量被手动关了。常见于旧项目迁移或 CI 环境误设。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查当前值：
go env GO111MODULE，若输出off就是问题根源 - 临时启用：
GO111MODULE=on go mod init example.com/foo - 永久修复：
go env -w GO111MODULE=on（推荐），或在 shell 配置中加export GO111MODULE=on - 注意：设为
auto时，仅当目录含go.mod或在 $GOPATH 外才启用，容易误判，不建议生产环境用
代理配置导致 go get 卡住或超时
国内直连 proxy.golang.org 和 sum.golang.org 几乎必失败，但错误信息常是模糊的 timeout 或 no required module provides package，而非明确提示代理问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先验证是否真卡在代理：运行
curl -v https://proxy.golang.org，看是否连接失败 - 设置国内镜像代理（2026 年仍有效）：
go env -w GOPROXY=https://goproxy.cn,direct - 同时关闭校验（避免 sum 错误）：
go env -w GOSUMDB=off（仅开发阶段，上线前应恢复） - 若用私有模块，把企业 Nexus 地址加到
GOPROXY列表末尾，用direct保底
GOPATH 还要不要配？配错会怎样
Go 1.13+ 启用 module 后，GOPATH 对依赖管理已无影响，但它仍控制 go install 生成的二进制存放位置（$GOPATH/bin），以及 go get 旧式用法的行为。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 新项目完全不用管
GOPATH，module 模式下所有依赖走go.mod和vendor或缓存 - 如果执行
go install后命令找不到，大概率是$GOPATH/bin没加入PATH，不是GOPATH本身设错了 - 避免手动设
GOPATH到项目目录——这会导致go mod误判为 legacy 模式，触发奇怪的 vendor 行为 - 查默认值：
go env GOPATH，通常为$HOME/go，保持它干净即可，不必动
go build 突然报一堆找不到包，或者 go test 在 CI 和本地行为不一致——这类问题往往藏在 GO111MODULE、GOPROXY、shell 环境加载顺序这些“看不见”的地方。 
