go version报command not found是PATH未配置或终端未刷新所致，需检查Go安装路径是否加入环境变量并重启终端验证。
go version 报 command not found
这不是 Go 没装，是系统根本找不到 go 命令。PATH 没配对，或者终端没刷新。
- Windows：检查
C:\Go\bin（或你自定义的安装路径）是否真实存在go.exe；在 PowerShell 运行$env:PATH -split ";" | Select-String "Go"看路径是否在列表里；若没有，用[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Go\bin", "User")追加，然后关掉所有终端重开 - macOS/Linux：确认
~/.zshrc（Catalina 后默认）或~/.bashrc里有export PATH=$PATH:/usr/local/go/bin，改完必须运行source ~/.zshrc；别漏掉which go验证是否生效 - 别信“自动配置”——MSI 安装包在 Windows 上有时只写用户变量，而某些工具（如 GoLand）读的是系统变量；ZIP 解压安装则完全靠手动加 PATH
go mod init 失败或卡住
模块初始化失败，90% 是网络或模块名不合规，不是代码问题。
- 国内直连
proxy.golang.org基本超时，先设代理：go env -w GOPROXY=https://goproxy.cn,direct；如果企业内网有私有仓库，顺手加go env -w GOPRIVATE=git.internal.company.com/* -
go mod init必须带参数，拒绝go mod init .或空参数；模块名不能含空格、中文、短横线、数字开头，推荐go mod init example.com/hello（哪怕只是本地练习） - 如果已生成错误的
go.mod，删掉它再重试；Go 不会覆盖旧模块名，只会沿用导致后续所有命令都报错
go run main.go 报 cannot find package 或 no Go files in directory
Go 1.16+ 默认强制 module mode，go run 不再看 GOPATH，只认当前目录有没有合法 go.mod。
- 先运行
ls go.mod（macOS/Linux）或dir go.mod（Windows）；没有？立刻go mod init example.com/hello - 别把
main.go放桌面或随便一个空文件夹就跑 —— 必须在go.mod所在目录（或其子目录）执行命令 - 检查文件开头是不是
package main（不是package hello，也不能漏）；确保main()函数签名是func main()，无参数、无返回值；多个.go文件必须全部属于package main - Windows 记事本保存可能插入 BOM 头，导致解析失败；换 VS Code 并选“UTF-8 无 BOM”保存
GoLand / VS Code 提示 No SDK 或 can't find import
IDE 不继承 shell 的环境变量，尤其是图形界面启动时，GOROOT 和 GOPATH 得手动喂给它。
立即学习“go语言免费学习笔记（深入）”；
- GoLand：设置 → Go → GOROOT，填的是 Go 安装根目录（如
C:\Go或/usr/local/go），不是bin子目录；填错直接识别失败 - VS Code：如果 Go 插件提示 “Installing tools failed”，先在终端执行
go env -w GOPROXY=https://goproxy.cn,direct和go env -w GO111MODULE=on，再重启编辑器；手动装核心工具：go install golang.org/x/tools/gopls@latest - 命令行能跑但 IDE 报错（比如
undefined: time.Duration），基本就是 IDE 没读到 GOROOT —— 它找不到标准库位置，不是你代码写错了
%USERPROFILE%\go\src，而你现在用 go mod 根本不需要它；有人强调必须设 GOPATH，其实 Go 1.16+ 已把它降级为缓存目录，默认值足够用。盯住 go version 和 go env GOPATH 的输出，比照着删掉多余配置，通常比重装更有效。 
