go version报错主因是path未生效：windows需重启终端或检查系统环境变量含go\bin，macos/linux需确认/usr/local/go/bin等路径已加入path并source生效。
go version 命令报错或不识别？先确认 PATH 是否生效
安装完 Go 后，go version 报 'go' is not recognized（Windows）或 command not found: go（macOS/Linux），本质是系统找不到 go 可执行文件。不是安装失败，而是环境变量没生效。
- Windows：安装程序通常自动写入
PATH，但需重启命令行（CMD/PowerShell）或整个终端窗口；若仍不行，手动检查系统环境变量中是否含C:\Program Files\Go\bin - macOS：用
.pkg安装的默认路径是/usr/local/go/bin，该路径应已加入PATH；若用 Homebrew 安装，路径为/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），运行echo $PATH确认 - Linux：解压到
/usr/local/go后，必须手动在~/.profile或/etc/profile中添加export PATH=$PATH:/usr/local/go/bin，然后执行source ~/.profile
go env GOPATH 显示空或异常？别硬改，Go 1.16+ 默认行为已变
执行 go env GOPATH 返回空值、~/go 或其他路径，都正常——从 Go 1.16 开始，GOPATH 不再影响模块构建逻辑，go mod 成为默认依赖管理方式。你完全可以在任意目录下初始化项目，无需把代码塞进 $GOPATH/src。
- 除非你维护老项目（
GO111MODULE=off模式），否则不用关心GOPATH路径是否“正确” -
go mod init myapp会自动生成go.mod，后续所有依赖都记录在此，与GOPATH无关 - 如果非要查默认路径，
go env GOPATH输出的就是当前生效值；它只影响go install生成的二进制存放位置（$GOPATH/bin），不影响开发流程
go get 失败提示 “timeout” 或 “no such host”？必须配国内代理
Go 默认代理 https://proxy.golang.org 在国内基本不可用，导致 go get、go mod download 卡住或失败，错误信息常含 lookup proxy.golang.org 或 context deadline exceeded。
- 执行这条命令即可切换为可用代理：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 不要用
https://goproxy.io（已停服），也不要漏掉,direct—— 它表示对私有模块（如公司内网 Git）直连，不走代理 - 如果公司有内部 Nexus 或 Artifactory，可设为
https://nexus.example.com/repository/golang-proxy，同样加,direct
VSCode 里无法跳转定义或提示空白？关键在 go.toolsGopath 配置
装了官方 Go 扩展后，Ctrl+Click 跳不到函数定义、没有参数提示、go test 按钮灰色，大概率是 VSCode 没找到本地 Go 工具链路径。
- 打开 VSCode 设置（
Cmd+, / Ctrl+,），搜索go.toolsGopath - 填入和
go env GOROOT一致的路径，例如/usr/local/go（Linux/macOS）或C:\Program Files\Go（Windows） - 注意：不是
GOPATH，也不是go env GOPATH的输出；toolsGopath是 VSCode 查找gopls、go、dlv等工具的根目录 - 改完重启 VSCode，新建
main.go再试；如果左下角出现gopls (initializing...)→gopls (running)，说明加载成功
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
