根本原因是系统path未包含go二进制目录；windows需检查msi是否勾选“add to path”或手动添加c:\program files\go\bin，macos/linux需将/usr/local/go/bin加入~/.zshrc等配置并source，且必须新开终端验证。
go version 报 command not found 怎么快速定位
根本原因是系统 PATH 没包含 go 二进制所在目录，不是“没装好”，而是“找不到”。Windows 安装 MSI 时若没勾选 “Add to PATH”，或 Linux/macOS 手动解压后没把 /usr/local/go/bin 加进 shell 配置，都会触发这个错误。
- 先运行
where go（Windows）或which go（macOS/Linux），看是否返回路径；没输出就说明 PATH 缺失 - 再检查
go文件是否存在：Windows 看C:\Program Files\Go\bin\go.exe或你自定义路径下的bin\go.exe；macOS/Linux 看/usr/local/go/bin/go - 确认 PATH 中的路径末尾必须带
\bin（Windows）或/bin（macOS/Linux），只加C:\Go或/usr/local/go是无效的 - 改完环境变量后，**必须新开终端**，PowerShell 还要执行
refreshenv，否则go version仍读旧缓存
GOROOT 和 GOPATH 还需要手动设吗
绝大多数情况不需要。Go 1.21+ 自动推导 GOROOT，GOPATH 也仅用于存放 go install 生成的可执行文件（即 $GOPATH/bin），不再是源码根目录。
-
GOROOT显式设置只在多版本共存且不改 PATH 时才必要；设错会导致cannot find package "fmt"这类标准库缺失报错 -
GOPATH如果没被旧脚手架或 CI 脚本依赖，可以完全不管；运行go env GOPATH查看当前值，默认是$HOME/go - 真正要配的是
$GOPATH/bin是否在 PATH 里——否则go install .编译出的命令无法全局调用 - IDE（如 VS Code Go 插件）会缓存这些变量，改完环境变量后必须重启编辑器，否则提示“package not found”是假报警
go mod init 为什么总报 malformed module path
模块路径不是文件系统路径，也不是随便起的名字。Go 要求它符合语义导入规则，否则后续加依赖、构建、发布全会卡住。
- 禁止用本地绝对路径：
go mod init /home/user/myproj❌ - 禁止含大写字母或下划线：
go mod init My_Project❌ - 推荐格式是域名反写 + 项目名：
go mod init github.com/yourname/myapp✅，即使代码没上传 GitHub 也没关系 - 纯本地测试可用占位符：
go mod init example.com/myapp，但所有import语句必须严格匹配该路径 - 初始化后检查
go.mod第一行是否为module example.com/myapp，不是module myapp—— 后者是常见误操作
国内用户必须配 GOPROXY 吗
不是“必须”，但不配大概率 go get 卡死或超时。官方代理 https://proxy.golang.org 在国内不可靠，而 goproxy.cn 或 mirrors.aliyun.com/goproxy 已稳定服务多年。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct即可生效，direct表示私有模块走直连 - 如果公司有私有代理（如 Nexus Go 仓库），把
https://goproxy.cn替换为对应地址即可 - 验证是否生效：运行
go env GOPROXY，输出应为设置的地址；再试go get github.com/spf13/cobra@v1.8.0，几秒内完成即成功 - 注意不要配成
https://goproxy.cn/（结尾斜杠），某些旧版 Go 会解析失败
go 命令能跑，插件却报一堆红色波浪线。遇到这种“一半正常一半异常”的情况，先关掉编辑器再重开。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
