根本原因是系统path未包含go二进制路径；windows需手动添加c:\go\bin到系统path，macos/linux需在~/.zshrc或~/.bash_profile中添加export path=$path:/usr/local/go/bin并source生效。
go version 报 command not found 怎么办
根本原因是系统 PATH 没包含 go 二进制路径，不是 Go 没装好。
- Windows：检查安装时是否勾选了 “Add Go to PATH”，没勾就手动把
C:\Program Files\Go\bin（或你自定义的安装路径）加到系统环境变量Path中 - macOS/Linux：默认解压到
/usr/local/go，但/usr/local/go/bin不在默认$PATH里，需在~/.zshrc或~/.bash_profile中追加：export PATH=$PATH:/usr/local/go/bin，然后执行source ~/.zshrc - 验证方式别只跑
go version，还要跑which go（macOS/Linux）或where go（Windows），确认输出路径指向你刚配置的目录
go mod init 报 malformed module path 怎么修
模块路径不是文件系统路径，而是虚拟导入路径；写错会导致后续所有依赖引入失败。
- 禁止用本地绝对路径，比如
go mod init /home/user/myproj—— 这直接报错 - 禁止含大写字母、下划线、空格，比如
go mod init My_Project或go mod init hello-world都不合法 - 推荐格式是域名反写 + 项目名，例如
go mod init github.com/yourname/cli-tool，即使没上传 GitHub 也建议这么写 - 纯本地测试可用占位符如
go mod init example.com/local，但所有import必须严格匹配该前缀
国内用户 GOPROXY 和 GOSUMDB 怎么设才不踩坑
不设代理，go get 和 go mod download 基本卡死；设错代理或校验和数据库，会连标准库都拉不下来。
- 推荐组合：
go env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org - 阿里云镜像（
https://mirrors.aliyun.com/goproxy/）也稳定，但注意末尾不要漏掉斜杠 -
GOSUMDB别关成off，否则go build可能因校验失败中断；国内镜像已同步官方 sumdb，保持默认即可 - 设完后运行
go env GOPROXY GOSUMDB确认值已生效，IDE（如 VS Code、GoLand）需重启才能读取新环境变量
多版本 Go 共存要不要设 GOROOT
绝大多数情况不需要，设了反而容易出问题。
-
GOROOT是 Go 安装根目录，现代 Go 安装包自带的go二进制会自动推导它；手动设错会导致cannot find package "fmt"这类标准库缺失错误 - 只有当你解压多个 Go 版本（如
/opt/go1.20、/opt/go1.25），又不想改PATH，才靠GOROOT切换 —— 但这属于非常规操作 - 更安全的方案是用
gvm或asdf管理多版本，它们通过 shell hook 动态切换PATH，不碰GOROOT - 如果已误设，运行
go env GOROOT对比which go的上级目录，不一致就删掉该环境变量
GO111MODULE、GOPROXY 或 PATH 后，必须重启编辑器，否则插件仍按旧配置工作。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
