装好go命令、配对PATH、启用模块模式三步完成即环境立住；go version报command not found是PATH未包含Go的bin目录，需手动确认并source或重启终端。
装好 go 命令、配对 PATH、启用模块模式，三件事做完，环境就算立住了——其余全是可选项。
go version 报 command not found 怎么办
不是没装好，是 shell 找不到 go 二进制。关键看 PATH 是否包含 Go 的 bin 目录。
- macOS/Linux：检查
which go有无输出；没有就确认/usr/local/go/bin（或你解压的实际路径）是否加进了~/.zshrc或~/.bash_profile，然后执行source ~/.zshrc - Windows：在 PowerShell 里运行
Get-Command go；失败就去「系统属性 → 高级 → 环境变量」，把C:\Go\bin（或你安装的实际路径）加进「系统变量」里的Path - 别信安装器勾选的“添加到 PATH”——它不一定生效，重启终端或手动
source才算数
go mod init 失败或生成空/错乱的 go.mod
常见于旧项目迁移或目录位置不对，go mod init 不是万能命令，它很依赖上下文。
- 先删掉项目根目录下的
vendor/目录（除非你明确要 vendor） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 确认当前目录不在
$GOPATH/src下——如果在，go mod init会按旧路径推导 module 名，大概率出错；建议切到任意非$GOPATH路径新建项目 -
go mod init前，目录下至少得有一个.go文件，否则可能静默失败
VS Code 里 gopls 启动失败或跳转失效
gopls 不是装上插件就自动好使的，它严格依赖 go 命令可用 + go.mod 存在 + 文件后缀合规。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
-
gopls报 “command not found”：说明 VS Code 没读到你的 shellPATH，去设置里填"go.goroot": "/usr/local/go"（路径按实际改） - 打开文件夹后一直转圈：检查根目录有没有
go.mod；没有就先跑go mod init example.com/foo - 跳转定义失效：确认文件是
.go后缀，且没被//go:build ignore屏蔽，也没写空的package main卡住解析
go install xxx@latest 提示 cannot find module providing package
这不是环境坏了，是你在某个模块目录里直接敲了 go install，Go 1.16+ 默认只认模块上下文。
- 退出当前项目目录，回到任意空目录再执行
go install golang.org/x/tools/gopls@latest - 确保
$GOPATH/bin已加入PATH，否则装完也找不到命令 - 如果还报错，检查
go env GOPROXY是否设为https://goproxy.cn,direct或https://proxy.golang.org,direct，国内不配代理基本拉不到包
最常被忽略的是 GOROOT 和系统自带 Go 冲突——比如 macOS 用 Homebrew 装过旧版，又手动解压新版，which go 和 go env GOROOT 输出不一致。这种时候删干净旧版、重置 PATH、重启终端，比调半天环境变量更省时间。
