根本原因是系统path未包含go可执行文件路径，需检查并添加/usr/local/go/bin（linux/macos）或c:\go\bin（windows）到path，然后重开终端或执行source命令生效。
go version 报 command not found 怎么办
根本原因是系统 PATH 没包含 go 可执行文件路径，不是 Go 没装好，而是找不到它。
- Linux/macOS：解压后默认在
/usr/local/go/bin，但该路径没加进$PATH；检查echo $PATH里有没有这个路径 - Windows：MSI 安装器默认勾选“Add to PATH”，但 ZIP 解压版不会自动加；手动确认环境变量
Path中是否含C:\Go\bin或你解压目录下的\bin - 验证方式别只信
go version，用which go（macOS/Linux）或where go（Windows）看实际调用的是哪个文件 - 改完配置记得重开终端，或运行
source ~/.zshrc（macOS）、source ~/.bashrc（Linux）、或重启 CMD/PowerShell（Windows）
GOROOT 和 GOPATH 还需要手动设吗
Go 1.21+ 大部分场景下不用设 —— 但得知道谁在依赖它们，否则会莫名其妙失败。
-
GOROOT：99% 的情况由go自动推导，除非你同时装了多个版本且不改PATH；设错会导致cannot find package "fmt"这类标准库报错 -
GOPATH：Go Modules 启用后已不强制要求，但旧脚手架、CI 脚本、某些 IDE 插件（如老版 VS Code Go 扩展）仍会读取；如果项目用dep或依赖$GOPATH/src结构，就得保留 - 当前推荐做法：不设
GOPATH，让项目自由放在任意路径；若必须兼容旧流程，可设为$HOME/go，但不要硬编码进 CI 配置 - IDE 缓存环境变量很顽固：VS Code 改完
GOPATH后必须完全退出再重开，否则插件仍用旧值
go mod init 报 malformed module path 怎么修
错误本质是模块名不符合 Go 的导入路径规则，不是拼写错，而是语义违规。
- 禁止用本地路径：比如
go mod init /home/user/myproj——/开头直接被拒 - 禁止含大写字母或下划线：如
go mod init My_Project会失败；Go 模块路径应全小写、用连字符（-），类似域名格式 - 正确写法是虚拟路径：哪怕没托管到 GitHub，也建议用
go mod init github.com/yourname/projectname或go mod init example.com/project - 本地测试可用占位符如
go mod init local/project，但所有import必须严格匹配，且不能推送到公共仓库
国内拉依赖超时或校验失败怎么办
核心是两件事：代理和校验开关，缺一不可；只配 GOPROXY 常常不够。
- 必须设代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（或你公司私有代理地址） - 必须关校验：国内镜像不提供 checksum，不关会卡在
verifying github.com/xxx@v1.2.3: checksum mismatch；运行go env -w GOSUMDB=off - 验证是否生效：执行
go env GOPROXY和go env GOSUMDB，输出应分别为你设的地址和off - 注意：
GOSUMDB=off仅适用于可信内网或开发阶段；上线前建议切回sum.golang.org并确保代理支持 checksum
go mod init 的路径写法 + GOSUMDB 是否关闭这两处。其他配置错了多半有明确报错，这两项错则静默失败或超时，容易反复折腾。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
