go version报错说明PATH未生效，需手动检查并添加Go的bin路径；go mod init失败多因路径在GOPATH/src下、存在vendor目录或GO111MODULE=off；国内需配置GOPROXY=https://goproxy.cn,direct；VS Code中gopls失败通常因环境配置不全而非插件问题。
go version 命令报错或找不到，说明 PATH 没生效
这是新手最常卡住的第一步。安装完 go 后执行 go version 提示 command not found 或 'go' is not recognized，不是没装好，而是系统根本“看不见”它。
- Windows：打开 PowerShell，运行
Get-Command go；若失败，去「系统属性 → 高级 → 环境变量」检查C:\Program Files\Go\bin（或你实际的安装路径）是否在PATH里 - macOS/Linux：终端执行
which go，没输出就说明没加进PATH；编辑~/.zshrc或~/.bash_profile，追加export PATH=$PATH:/usr/local/go/bin（macOS 默认路径），然后source ~/.zshrc - 别信安装器说的“已添加 PATH”——重启终端或手动
source才生效
go mod init 初始化失败，常见静默陷阱
go mod init 看似简单，但会在几个地方悄悄失败，且不报错。
- 当前目录在
$GOPATH/src下（比如~/go/src/myproject）：go mod init会尝试按旧 GOPATH 规则推导 module 名，结果生成错误的go.mod，比如module github.com/xxx/yyy而非你想要的module myweb - 项目根目录下存在
vendor/目录：模块模式可能被干扰，建议先rm -rf vendor -
GO111MODULE被设为off：运行go env -w GO111MODULE=on强制启用（Go 1.16+ 默认开启，但某些脚本或 CI 环境可能关着） - 正确做法：切到任意非
$GOPATH/src的干净目录（如~/projects/myweb），再执行go mod init myweb
国内依赖下载慢或超时，必须配 GOPROXY
不配代理的话，go get 或 go mod tidy 很可能卡住、失败，甚至误判为网络不通。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 执行命令设置国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应输出上述地址 -
direct表示对私有模块（如公司内网 Git）直连，不走代理，这个后缀不能省 - 如果用的是 VS Code，插件自动调用
go工具链，也受此配置影响；不用额外在编辑器里设代理
VS Code 中 gopls 启动失败，不是插件问题
VS Code 提示 “Language Server is not running” 或代码无提示，90% 不是插件没装对，而是底层环境不合规。
- 确认
go命令可用：go version能正常输出 - 确认项目根目录有
go.mod文件（哪怕空的），且文件名拼写正确（不是gomod或go.mod.bak） - 确认当前打开的是项目根目录（不是父目录或子目录），VS Code 左下角应显示 Go SDK 版本
- 如果刚配好
GOPROXY，重启 VS Code 才能加载新配置
真正容易被忽略的，是 go mod init 对路径的隐式依赖——它不报错，但生成的 module 名不对，后续所有 import 和 go get 都会偏离预期。动手前先 pwd 看一眼当前路径，比反复重装 Go 有用得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
