go version报“command not found”根本原因是PATH未正确配置或未生效：Windows需重启终端或手动配置Git Bash的PATH，macOS/Linux必须执行source ~/.zshrc等使配置生效，并用echo $PATH或echo %PATH%验证路径是否包含Go的bin目录。
Go 环境搭不好，go run 都报错，更别说写业务了。现在直接上手，不绕弯子。
验证 go version 失败的常见原因
终端敲 go version 报 command not found: go，不是没装，大概率是 PATH 没生效。
- Windows 用户：安装 .msi 后默认会改系统 PATH，但需重启命令行（或 PowerShell）；用 Git Bash 的话，PATH 不自动继承，得手动加
C:\Go\bin - macOS/Linux 用户：
source ~/.zshrc或source ~/.bash_profile必须执行，光改文件不 reload 没用 - 检查是否真在 PATH 里：
echo $PATH | grep -o "/usr/local/go/bin"（macOS/Linux）或echo %PATH%（Windows）搜C:\Go\bin
go mod init 报错 “cannot find module providing package”
这不是环境问题，是模块初始化路径不对。Go Modules 要求项目目录不能在 $GOPATH/src 下（老式 GOPATH 模式已淘汰）。
- 新建项目必须在任意空目录下，比如
/home/user/myapp，而不是$GOPATH/src/github.com/xxx/myapp - 运行
go mod init myapp时，模块名建议用实际域名或有意义的标识，别用main或test - 如果已有
go.sum但依赖拉不下来，先确认go env -w GOPROXY=https://goproxy.cn,direct已设置（国内必备）
VS Code 装完 Go 插件还不能跳转、补全
官方 Go 扩展会提示安装工具链，但很多用户点了“取消”或网络卡住，导致 gopls（语言服务器）没装上。
立即学习“go语言免费学习笔记（深入）”；
- 手动触发安装：Cmd+Shift+P → 输入 “Go: Install/Update Tools”，勾选全部，尤其是
gopls和goimports - 检查
gopls是否就位：which gopls（macOS/Linux）或where gopls（Windows），输出应在$GOPATH/bin或$GOROOT/bin - 若仍无效，在 VS Code 设置里搜 “go.gopath”，确认为空（现代 Go 不再依赖 GOPATH，留空即可）
go build 出来的二进制文件启动慢、体积大
这是默认行为，不是 bug。Go 编译产物自带调试信息和符号表，开发阶段没问题，上线前必须优化。
- 减小体积：
go build -ldflags="-s -w" main.go，-s去符号表，-w去 DWARF 调试信息 - 静态链接（避免 libc 依赖）：
CGO_ENABLED=0 go build -a -ldflags="-s -w" main.go，尤其适合容器部署 - 注意：
CGO_ENABLED=0会让net包回退到纯 Go 实现，DNS 解析可能变慢，生产环境需实测
真正容易被忽略的点是：Go Modules 默认开启（GO111MODULE=on），但旧项目迁移时，如果根目录下有 vendor/ 且没删干净，go build 会优先用 vendor 里的代码，导致依赖版本混乱 —— 遇到奇怪行为，先 rm -rf vendor 再试。
