go version报错说明PATH未生效，需检查echo %PATH%是否含C:\Go\bin，否则手动添加并重启终端；国内还需配置GOPROXY=https://goproxy.cn,direct。
go version 命令报错或无输出，说明安装没生效
这不是 Go 没装好，而是 PATH 没配对。Windows 上 MSI 安装器默认会把 C:\Go\bin 加进系统 PATH，但某些情况下（比如非管理员安装、多用户环境）它可能只加进了当前用户的 PATH，而命令提示符没读到更新。
验证方法：打开全新的 cmd 或 PowerShell，执行 echo %PATH%，看输出里有没有 C:\Go\bin；macOS/Linux 执行 echo $PATH，确认含 /usr/local/go/bin。
- 没看到？手动添加：
setx PATH "%PATH%;C:\Go\bin"（Windows），或在~/.zshrc末尾加export PATH=$PATH:/usr/local/go/bin（macOS/Linux），然后重启终端 - 路径里有中文或空格？立刻重装到纯英文路径，比如
C:\Go或/usr/local/go，否则后续go get、go mod都可能静默失败 - 仍不行？直接运行
C:\Go\bin\go.exe version测试二进制是否可用——如果这个能输出版本，问题100%出在PATH
go run main.go 提示 “cannot find package” 或卡在下载阶段
这是代理没设或模块模式冲突的典型表现。2026 年国内访问 golang.org/x/... 等包基本不可达，不设代理，go run 会卡住或报错找不到标准库扩展包（比如 golang.org/x/sys）。
别用 GO111MODULE=off 回退到 GOPATH 时代——那只是掩盖问题，且和现代生态脱节。
立即学习“go语言免费学习笔记（深入）”；
- 先检查当前模块状态：
go env GOMOD，如果输出为空，说明当前目录没go.mod，go run会尝试启用模块模式但没代理就失败 - 临时设置代理（推荐）：
go env -w GOPROXY=https://goproxy.cn,direct，国内稳定，支持私有模块 fallback - 如果公司内网限制 HTTPS 代理，改用
go env -w GOPROXY=http://proxy.golang.com.cn,direct（注意是http://） - 验证代理生效：
go env GOPROXY应输出你刚设的地址；再试go run main.go，首次会下载依赖，几秒内应开始编译
VS Code 里 Ctrl+Click 跳不到函数定义，或没有代码补全
不是插件没装，而是 Go 扩展没找到 go 二进制，或者工作区没激活模块支持。
打开 VS Code 终端，执行 which go（macOS/Linux）或 where go（Windows），确认路径和 go version 一致；再执行 go env GOPATH，看是否指向你期望的位置。
- VS Code 右下角状态栏如果显示 “No SDK” 或 “Go is not installed”，点击它，手动指定
go路径（比如C:\Go\bin\go.exe） - 项目根目录没有
go.mod？在终端里执行go mod init example.com/hello，哪怕只是个空文件，Go 扩展才能正确加载分析器 - 补全延迟高？关掉
"go.useLanguageServer": false这类手动关闭 LSP 的配置——现代 Go 扩展依赖gopls，关了等于废一半功能 - 跳转失效还可能是缓存问题：按
Ctrl+Shift+P→ 输入 “Go: Restart Language Server”，强制刷新索引
go build 生成的 .exe 运行一闪而退，看不到输出
这是 Windows 控制台程序的常见现象，跟 Go 本身无关，但新手容易以为代码错了。
go build 生成的是控制台程序，双击运行后，输出完立刻退出，窗口自动关闭。
- 正确做法：在终端里运行
.\main.exe，这样输出停留可见 - 想双击看效果？在
main()最后加一行fmt.Scanln()，等用户按回车才退出（仅调试用，上线前删掉） - 更彻底的方案：用
go run main.go替代构建——开发阶段没必要反复生成 exe，go run编译+执行一步到位，且错误信息更完整 - 如果连
go run都黑屏无输出，检查fmt.Println拼写（不是Println小写 L，也不是print）和包导入：import "fmt"缺一不可
go run main.go 并看到输出，比纠结 GOROOT 和 GOBIN 的理论值重要得多。很多坑不是配置错，而是某次安装残留、终端没刷新、或 VS Code 没 reload 工作区导致的——遇到卡点，先关掉所有终端和编辑器，重开再试。 
