go version报command not found是因为PATH未包含$GOROOT/bin；macOS/Linux需检查~/.zshrc并source，Windows需在系统环境变量中添加Go安装路径的bin目录并重启终端。
Go 环境装不上、go version 报 command not found、go run 找不到包、VS Code 里标红说 package not found——这些问题几乎都卡在环境变量和模块模式的配合上，不是安装失败，而是 PATH 没生效、GO111MODULE 没开、或者项目位置踩进了 GOPATH/src 的旧路径陷阱。
go version 报 command not found 怎么办
这不是 Go 没装好，是 shell 找不到 go 可执行文件。关键看 PATH 是否包含 $GOROOT/bin（Windows 是 %GOROOT%\bin）。
- macOS/Linux：运行
which go；没输出就检查~/.zshrc或~/.bash_profile里是否加了export PATH=$PATH:$GOROOT/bin，然后source ~/.zshrc - Windows：用 PowerShell 运行
Get-Command go；失败就去「系统属性 → 高级 → 环境变量」确认Path里有C:\Go\bin（或你实际的安装路径），改完必须重启终端 - 别信安装器勾选的“添加到 PATH”——它不一定生效，手动验证最可靠
go mod init 失败或生成错误 module 名
常见现象：执行 go mod init myproject 后，go.mod 里 module 名变成 myproject，但后续 go run 报错说找不到包，或者 import 路径被自动推成 github.com/xxx/yyy。
- 先确认当前目录不在
$GOPATH/src下——如果在，go mod init会按旧 GOPATH 规则推导 module 名，大概率出错；直接cd ~/Desktop新建空目录再试 - 删掉项目根目录下的
vendor/目录（除非你明确要用 vendor） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但某些 CI 或老脚本可能关着） - 确保没有残留的
GO111MODULE=off环境变量（用go env | grep GO111MODULE查）
VS Code 里 gopls 启动失败或标红
gopls 不是插件装上就跑，它依赖底层 go 命令可用 + 项目结构合规 + go.mod 存在。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 打开 VS Code 终端，先运行
go version和go env，确认 go 可用且GOPROXY、GO111MODULE设置正确 - 项目根目录必须有
go.mod文件（哪怕只是go mod init xxx初始化过） - 确保文件后缀是
.go，且 package 声明合法（比如package main） - 如果提示 “gopls not found”，在 VS Code 中按
Cmd/Ctrl+Shift+P→ 输入 “Go: Install/Update Tools”，全选安装
GOROOT 和 GOPATH 还需要手动配吗
Go 1.16+ 完全可以不设 GOPATH，GOROOT 也极少需要手动改——它由安装程序自动设好，指向 Go 安装目录（如 /usr/local/go 或 C:\Go）。
-
GOROOT：一般不用动；只有当你手动解压 tar.gz 到非标准路径时，才需go env -w GOROOT=/your/path -
GOPATH：Go Modules 模式下已不参与依赖查找，只影响go install输出二进制的位置（即$GOPATH/bin）；如不需要全局命令，可跳过设置 - 真正要盯的是
GOBIN：如果你想把go install的结果放别的地方，用go env -w GOBIN=/your/bin/path，然后确保该路径进了PATH
最容易被忽略的是：模块模式启用状态、项目路径是否落在 GOPATH/src 下、以及 VS Code 里 gopls 启动前有没有 go.mod ——这三处一错，IDE 就罢工，但错误提示往往藏在日志里，不直接报出来。
