go version报错或无输出说明goroot和path未生效：windows需检查系统环境变量中path是否含go安装路径，macos/linux须手动导出goroot并追加$goroot/bin到path，且source配置文件后新开终端验证。
go version 命令报错或无输出，说明环境变量没配对
装完 Go 后直接在 CMD 或 Terminal 里敲 go version，如果提示“命令未找到”或空白输出，不是没装好，而是 GOROOT 和 PATH 没生效。
- Windows 安装 MSI 包默认会自动配置环境变量，但某些杀毒软件或系统策略会拦截写入，建议手动检查：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，确认
PATH中包含类似C:\Program Files\Go\bin的路径 - macOS/Linux 手动解压安装时，必须显式导出：
export GOROOT=/usr/local/go和export PATH=$PATH:$GOROOT/bin；写进~/.zshrc（macOS）或~/.bashrc（Linux）后，要执行source ~/.zshrc - 别信“重启终端就生效”——有些终端启动时不会重读 shell 配置，新开一个窗口再试，或直接运行
echo $PATH看有没有go/bin路径
go run hello.go 提示 cannot find package "fmt"
这通常不是缺包，而是当前目录不在 GOPATH 或模块初始化失败。Go 1.16+ 默认启用 module 模式，但旧教程常忽略这一步。
- 新建项目前，先在项目根目录运行
go mod init example.com/hello（域名随便写，只是模块标识，不联网验证） - 确保
hello.go文件开头是package main，且文件名不叫main.go以外的其他名字（比如hello.go没问题，但test.go如果没加package main就会报错） - 如果仍报错，检查是否误设了
GO111MODULE=off——这个开关会强制退回到 GOPATH 模式，而新项目没放对位置就会找不到标准库
VS Code 里写 fmt.Println() 没智能提示，或红色波浪线标错
VS Code 不是装了 Go 插件就自动好使，它依赖本地 Go 工具链完整安装并可被识别。
- 先确认
go version在终端能跑通，再重启 VS Code —— 插件启动时会调用go env获取配置，终端不通，插件也瘫痪 - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），搜 “Go: Install/Update Tools”，勾选全部，点“OK”；它会自动下载gopls（语言服务器）、dlv（调试器）等，缺任何一个都会导致提示失效 - 如果卡在 “Fetching gopls…” ，大概率是代理问题：在设置里搜
go.toolsEnvVars，添加"GOPROXY": "https://proxy.golang.com.cn,direct"
go build 生成的二进制文件运行时报 “permission denied”
尤其在 macOS 或 Linux 上，go build 出来的文件默认没有执行权限，但 go run 是直接解释执行的，所以不会暴露这个问题。
- 直接运行
./hello前，先执行chmod +x hello - Windows 不需要这步，但如果你在 WSL 里操作，就得当 Linux 对待
- 更稳妥的做法是用
go install（需先设GOBIN），它会把可执行文件放进$GOBIN目录，并自动赋予权限
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
