go命令找不到的主因是PATH未配置，需确认Go安装路径（如/usr/local/go/bin）、将对应bin目录加入PATH、重载shell配置（如source ~/.zshrc）并重启终端验证。

go 命令找不到，不是 Go 没装好，是系统根本没“看见”它——PATH 没配对，这是 90% 场景下的唯一原因。

which go 没输出？立刻检查 PATH 是否包含 go/bin

终端运行 which go（macos/linux）或 where go（windows），没任何输出就坐实了 path 问题。

• 先确认 Go 实际解压/安装在哪：ls /usr/local/go/bin/go（Linux/macOS）或 dir C:\Go\bin\go.exe（Windows），路径不对就白配
• macOS/Linux：编辑 ~/.zshrc（默认 shell）或 ~/.bash_profile，加一行：export PATH=$PATH:/usr/local/go/bin（路径按你实际改）
• Windows：进「系统属性 → 高级 → 环境变量」，在「系统变量」的 Path 里新增 C:\Go\bin
• 改完必须 source ~/.zshrc（或重启终端），否则配置不生效

宝塔面板或 CI 脚本里 go 找不到？别只改用户配置

宝塔后台、计划任务、WebHook 触发的命令走的是系统级环境，不是你登录用户的 shell 配置。

• 必须改全局配置：sudo nano /etc/profile，末尾加两行：
  export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
• 然后 source /etc/profile，再切到普通用户（如 www）执行 go version 验证
• 别信宝塔 Web 终端能自动加载你的 ~/.zshrc——它不读用户级文件

go version 有输出，但 go install 或 go mod 报错？模块模式可能关着

go version 成功只说明命令通了，不代表模块功能可用。常见报错如 cannot find module providing package，大概率是 GO111MODULE 关着。

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

• 运行 go env GO111MODULE，如果输出 off，就立即开：go env -w GO111MODULE=on
• 开之后，go mod init 才会生成 go.mod，go install xxx@latest 才能在任意空目录执行
• 老项目若依赖 $GOPATH/src 结构，临时关掉：GO111MODULE=off go run main.go

VS Code 里 gopls 启动失败或跳转失效？别只盯着插件

VS Code 的 Go 插件不会自动继承你终端的 PATH，尤其当你用 zsh 但 Code 启动自 bash 时。

• 打开 VS Code 设置，搜 go.goroot，手动填绝对路径，比如 /usr/local/go
• 确保项目根目录有 go.mod，没有就先 go mod init example.com/foo
• 文件后缀必须是 .go，且不能被 //go:build ignore 屏蔽，空的 package main 也会卡住解析

最常被忽略的其实是 GOROOT 冲突：Homebrew 装过旧版 Go，又手动解压新版，结果 go env GOROOT 输出的是错误路径。删掉所有 shell 配置里手写的 export GOROOT=...，让 Go 自己推导，通常更稳。