应手动将/usr/local/go/bin加入path，否则go version会报command not found；go mod init报错多因目录在$gopath/src下或go111module未启用，需切换干净路径并强制开启模块模式；vs code中gopls卡住主因代理未配置，须设goproxy=https://goproxy.cn,direct并关闭gosumdb。
直接装官方二进制包，别用包管理器——这是最不容易出错的起点。
go version 命令报 command not found 怎么办
这不是 Go 没装好，而是 PATH 没配对。Windows 用 MSI 安装后一般自动配置好了，但 macOS/Linux 必须手动把 /usr/local/go/bin 加进 PATH。
- macOS/Linux：检查
echo $PATH输出里有没有/usr/local/go/bin；没有就执行export PATH=$PATH:/usr/local/go/bin，再加到~/.zshrc或~/.bashrc末尾并source一次 - Windows：打开 CMD 运行
where go，如果没输出，说明安装路径（比如C:\Go\bin）没加进系统Path环境变量 - 别信“安装完就能用”的说法——很多新手卡在这一步，反复重装 Go，其实只是 PATH 少了一行
go mod init 报 failed to load config: unknown module root 错误
这个错误根本不是模块问题，而是当前目录在 $GOPATH/src 下，且 Go 旧版本残留逻辑被触发了。现代 Go（1.16+）默认开启 GO111MODULE=on，但某些终端会继承旧 shell 的环境变量或缓存。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 先运行
go env -w GO111MODULE=on强制启用模块模式 - 确保不在
$GOPATH/src目录下操作——新建个干净目录，比如~/projects/hello，cd 进去再go mod init hello - 删掉项目里残留的
vendor/或Gopkg.lock文件，它们会干扰模块初始化 - 如果还报错，试试
go env -u GOPATH临时取消 GOPATH 影响（仅调试用）
VS Code 打开 .go 文件后 gopls 一直 loading 或崩溃
90% 是代理没设对，gopls 启动时会尝试下载依赖校验数据，国内直连 sum.golang.org 极易超时卡死。
- 运行
go env -w GOPROXY=https://goproxy.cn,direct和go env -w GOSUMDB=off（学习阶段可关校验，避免阻塞） - 重启 VS Code，不要只重载窗口——彻底退出再打开
- 首次打开 .go 文件时，底部状态栏若显示 “Installing tools…”，点进去勾选全部，尤其是
gopls、dlv、goimports，别跳过 - 如果仍卡住，删掉
~/.vscode/extensions/golang.go-*/out/tools目录，让插件重下工具链
真正容易被忽略的点是：你不需要理解 GOPATH、GOROOT 或模块原理才能写第一个程序；只要 go version 能跑、go mod init 能生成文件、VS Code 里能跳转函数，环境就算搭成了。后面遇到具体问题再针对性查，别一上来就钻配置细节。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
