go version报错或找不到，说明PATH未生效：Windows需重开CMD/PowerShell，Linux/macOS需确认/usr/local/go/bin已加至PATH并source配置文件；同时检查go可执行文件是否存在，GOROOT不得设为用户目录。
go version 命令报错或找不到，说明环境变量没生效
最常见的情况是安装完 go 后直接在旧终端里执行 go version，结果提示“command not found”。这不是安装失败，而是 PATH 没刷进去。
Windows 用户装的是 .msi 包，安装程序会自动写入系统 PATH，但必须关闭并重新打开所有 CMD/PowerShell 窗口；Linux/macOS 用户如果手动解压到 /usr/local/go，得确认 PATH 里加了 /usr/local/go/bin，且 shell 配置文件（如 ~/.zshrc）已用 source 重载。
- 检查是否真有
go可执行文件：ls /usr/local/go/bin/go（Linux/macOS）或dir "C:\Program Files\Go\bin\go.exe"（Windows） - 别把
GOROOT设成用户目录（比如C:\Users\xxx\go），它只该指向 Go 安装根目录 - Go 1.16+ 默认不依赖
GOPATH，除非你用老项目或某些工具链（如旧版golint），否则不用刻意配
go mod init 失败或依赖拉不下来，大概率是 GOPROXY 没设对
国内直连 proxy.golang.org 基本超时，go get 或 go build 卡住、报 timeout 或 no matching versions，基本就是代理问题。
执行这条命令即可设好国内镜像：
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPROXY=https://goproxy.cn,direct
注意结尾的 ,direct 不能丢——它表示当模块在代理里找不到时，回退到直接从源仓库拉（比如公司私有模块）。
- 不要用已停服的代理，比如
https://goproxy.io（2025 年底已下线） - 验证是否生效：
go env GOPROXY应输出刚设置的地址 - 如果公司内网有私有模块仓库，可追加多个代理，用逗号分隔，顺序靠前的优先尝试
VS Code 提示 “Install all tools” 卡住或失败，优先手动装 gopls 和 dlv
VS Code 的 Go 插件首次打开 .go 文件时弹出的安装面板，常因网络或权限问题卡在 gopls 或 dlv 上。与其等它，不如自己动手：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
运行这两条命令（Go 1.21+ 推荐带 @latest）：
go install golang.org/x/tools/gopls@latest<br>go install github.com/go-delve/delve/cmd/dlv@latest
装完后重启 VS Code，插件会自动识别已安装的二进制。
-
gopls是语言服务器核心，没它就没有跳转、补全、诊断；dlv是调试器，没它就无法 F5 调试 - 别用
go get（已废弃），必须用go install+ 模块路径 +@latest - 装完检查位置：
go list -f '{{.Target}}' golang.org/x/tools/gopls@latest，确保生成的二进制在$GOPATH/bin或go env GOPATH对应的bin目录下
go fmt 和 go vet 不生效？要确认它们是否被编辑器集成
这两个不是开箱即用的功能，需要编辑器明确调用。VS Code 默认不会在保存时自动格式化，除非你配置了：
在设置里搜 format on save，勾选；再搜 default formatter，设为 golang.go。这样保存时才会跑 gofmt（或更现代的 goimports）。
go vet 属于静态检查，VS Code 的 Go 插件默认开启，但只在编辑时后台运行。如果想手动触发，终端进项目根目录后执行：
go vet ./...
-
go fmt ./...只格式化当前目录及子目录下的文件，不递归处理 vendor 或 testdata - 若想统一用
goimports（自动管理 import 行），需额外装：go install golang.org/x/tools/cmd/goimports@latest，然后在 VS Code 设置里指定它为 formatter -
go vet不检查语法错误，只查逻辑隐患（比如Printf参数类型不匹配），和staticcheck是互补关系，不是替代
真正容易被忽略的点是：Go Modules 的启用与否，会彻底改变依赖查找路径和 go install 工具的行为。如果你在非 module 项目里运行 go install，它可能把二进制装到 $GOPATH/bin；而 module 模式下，go install 默认只装当前模块的命令，除非显式指定完整路径（如 go install example.com/cmd/foo@latest）。这点不厘清，工具装了也找不到。
