go version报错说明PATH未正确配置，需手动将Go的bin目录（如C:\Program Files\Go\bin）添加到用户级PATH并重启命令行；同时应设置GOROOT、GOPATH、GOBIN，并启用GO111MODULE=on及GOPROXY=https://goproxy.cn,direct。
go version 命令报错或不识别，说明 PATH 没配对
Windows 上装完 .msi 后直接开 CMD 运行 go version 报“不是内部或外部命令”，基本就是 %GOROOT%\bin 没进系统 PATH。MSI 安装器在较新版本（1.21+）默认会自动加，但遇到某些安全策略或旧版系统仍可能失败。
- 手动检查：打开「系统属性 → 高级 → 环境变量」，确认
PATH中存在类似C:\Program Files\Go\bin的条目（路径需与你实际安装位置一致） - 别漏掉
%GOPATH%\bin：虽然 Go Modules 已成主流，但部分工具（如gopls、dlv）安装后会落在此目录，没它会导致 VS Code 插件提示“找不到调试器” - 改完环境变量必须新开终端：CMD/PowerShell 不会自动刷新继承的环境变量，关掉重开才能生效
go mod init 失败提示 “cannot determine module path”，是因为当前目录不在 GOPATH 且没设 GO111MODULE
这个错误常出现在老教程照搬操作时——比如你在 D:\myproject 直接运行 go mod init，却没启用模块模式，Go 会退回到 GOPATH 模式并试图从路径推导包名，失败就报这句。
- 先执行
go env -w GO111MODULE=on（推荐全局开启，避免每个项目都设） - 再运行
go mod init example.com/myapp，显式指定模块路径，不用依赖目录结构 - 注意：如果之前用过 GOPATH 模式且目录在
%GOPATH%\src下，Go 可能仍尝试按旧规则解析，建议新建干净目录重试
GOPROXY 设置无效，go get 仍卡在 proxy.golang.org
国内用户最常踩的坑：设置了 GOPROXY，但 go env GOPROXY 显示还是默认值，或者设置后 go get 依然超时。根本原因是环境变量作用域和优先级问题。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确认设置方式：用
go env -w GOPROXY=https://goproxy.cn,direct（不是set或$env:），这是 Go 自己管理的配置，比系统环境变量更可靠 - 检查是否被覆盖：某些 IDE（如旧版 Goland）或 shell 启动脚本会重置
GOPROXY，运行go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux）看最终生效值 -
direct必须保留：它表示对私有仓库跳过代理，漏写会导致公司内网模块拉取失败
VS Code 提示 “The 'gopls' server crashed”，其实是工具链没装全
这不是 gopls 本身的问题，而是它依赖的底层工具（如 go、gofmt、goimports）缺失或版本不匹配。VS Code Go 插件默认会尝试自动安装，但国内网络常中断导致半残状态。
立即学习“go语言免费学习笔记（深入）”；
- 手动补全：在项目根目录运行
go install golang.org/x/tools/gopls@latest，确保装到%GOPATH%\bin（或go env GOPATH输出的路径下） - 验证路径：在终端执行
which gopls（macOS/Linux）或where gopls（Windows），输出应为xxx\bin\gopls.exe - 别用
go get：Go 1.21+ 已弃用go get安装命令行工具，必须用go install，否则装到go.mod里反而引发冲突
