go命令无法识别的根本原因是path未生效；需将/usr/local/go/bin（macos/linux）或c:\go\bin（windows）加入path，编辑对应shell配置文件并source，再验证go version。
装好 go 命令并让它在终端里能直接敲出来，就是环境搭好了——其他全是锦上添花或排障步骤。
go version 报 command not found 怎么办
这不是 Go 没装，是系统根本找不到 go 这个可执行文件。核心就一条：PATH 没生效。
- macOS/Linux：运行
which go，没输出就说明 PATH 里没加/usr/local/go/bin（或你解压的路径）；检查~/.zshrc或~/.bash_profile里有没有export PATH=$PATH:/usr/local/go/bin，改完必须source ~/.zshrc - Windows：用 PowerShell 跑
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」确认C:\Program Files\Go\bin是否进了用户或系统 PATH；别信安装器勾选的“添加到 PATH”，它只在新终端生效 - 统信 UOS 等国产 Linux：APT 安装后可能不自动设 PATH，得手动
echo 'export PATH=$PATH:/usr/lib/go/bin' >> ~/.bashrc（路径以dpkg -L golang查为准）
go mod init 失败但没报错，怎么回事
静默失败最常见于模块模式被关了，或项目卡在旧式 GOPATH/src 路径下。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 先强制开模块：
go env -w GO111MODULE=on（Go 1.16+ 默认开，但 CI/老脚本可能关着） - 删掉项目根目录下的
vendor/目录（除非你明确要 vendor） - 别在
$GOPATH/src里初始化项目——比如~/go/src/myapp下跑go mod init，会试图推导 module 名为myapp，但实际应为github.com/xxx/myapp；直接切到~/projects/myapp这类非 GOPATH 路径再试
VS Code 里 gopls 启动失败、没提示、格式化失效
gopls 不是插件装上就行，它依赖三件事同时成立：终端能跑 go、当前文件夹有 go.mod、文件后缀是 .go。
- 打开 VS Code 终端，输入
go version和go env GOROOT，确保都正常；如果报错，说明编辑器没继承系统 PATH（macOS 尤其常见，试试从命令行用code .启动） - 确认项目根目录下有
go.mod文件；没有就先go mod init example.com/myapp - 检查文件名是不是
main.go，不是main.G0或Main.go——大小写和后缀错一个，gopls就不认 - 国内用户常卡在工具下载：在 VS Code 设置里搜
go.toolsEnvVars，加一行"GOPROXY": "https://goproxy.cn,direct"
真正容易被忽略的是：go 命令本身是否可用，比任何 IDE 配置都优先。所有“功能不工作”的问题，90% 先回到终端验证 go version 和 go list -m 是否正常——其余都是衍生产物。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
