go version报错“command not found”根本原因是PATH未包含Go的bin目录；需在macOS/Linux中向~/.zshrc添加export PATH=$PATH:/usr/local/go/bin并source，在Windows中将C:\Program Files\Go\bin加入系统环境变量Path。
go version 命令没反应？先确认 PATH 和 bin 目录是否生效
安装完 Go 后，go version 报“不是内部或外部命令”是 Windows 和 Linux 新手最常遇到的问题。根本原因不是没装好，而是 go 可执行文件路径没进系统 PATH。
Windows 默认安装会自动把 C:\Program Files\Go\bin 加入系统环境变量，但如果你用的是非管理员账户、或者手动解压的 tar.gz 包，这步就可能被跳过。Linux/macOS 下更常见：你解压到了 /usr/local/go，却忘了运行 source ~/.bashrc 或 source ~/.zshrc。
- 检查方法：在终端里运行
echo $PATH（Linux/macOS）或echo %PATH%（Windows），看输出里有没有go/bin路径 - 临时修复：直接运行
/usr/local/go/bin/go version（Linux/macOS）或C:\Program Files\Go\bin\go.exe version（Windows），验证二进制本身是好的 - 永久修复：把
go/bin路径加到用户级环境变量，别动系统级 PATH；重启终端再试
go env 显示 GOPATH 是 ~/go，但项目里 import 就报错？关掉 GOPATH 模式
你新建了个项目，go mod init myapp 也跑了，可一写 import "github.com/sirupsen/logrus"，go run 还是提示找不到包——大概率是 IDE 或 shell 里残留了旧习惯：GO111MODULE=off 或者启用了 GOPATH 模式。
现代 Go（1.16+ 默认开启 Modules）完全不依赖 GOPATH/src 来找第三方包。一旦 GO111MODULE=off，Go 就会忽略 go.mod，退回到老式查找逻辑：只在 GOPATH/src 和 GOROOT/src 里翻，自然找不到你 go get 下来的模块。
- 查当前状态：运行
go env GO111MODULE，输出必须是on - 强制开启（推荐）：执行
go env -w GO111MODULE=on，写入用户配置 - VS Code 用户注意：如果装了旧版 Go 插件，它可能默认关 Modules；在设置里搜
go.useLanguageServer和go.toolsEnvVars，确保没手动设成off
go get github.com/xxx 失败，超时或 403？必须配代理和校验开关
国内直连 golang.org/x/... 或 GitHub 经常失败，错误像 could not determine kind of name for C.xxx 或 403 Forbidden，表面是网络问题，实则是 Go 工具链在 fetch 时卡在证书校验或重定向上。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
光换镜像源不够。Go 1.21+ 默认启用校验（GOSUMDB=sum.golang.org），而这个服务在国内也不稳定，会导致 go get 卡住甚至失败。
- 一步到位配置（推荐）：
go env -w GOPROXY=https://mirrors.aliyun.com/golang/ go env -w GOSUMDB=off
- 不用全局关
GOSUMDB的话，可以只对当前项目临时关：GOSUMDB=off go get github.com/xxx - 阿里云镜像地址比官方 proxy.golang.org 更稳；不要用已停更的 goproxy.cn
go run main.go 成功，但 go build -o app 报 undefined: xxx？检查 main 包文件是否全被包含
go run 能跑不代表 go build 一定能编译出可执行文件。典型现象：项目有 main.go 和 handler.go，go run . 没问题，但 go build -o app 提示函数未定义——因为 go build 默认只编译当前目录下所有 .go 文件，而 go run . 会递归扫描整个模块。
这不是 bug，是设计行为。尤其当你用 go build ./cmd/myapp 这种子目录方式时，必须确保该目录下包含完整的 main 包文件，不能靠跨目录 import “补全”。
- 安全做法：始终用
go build .（当前目录）或go build ./...（整个 module） - 若要指定入口，用
go build -o app ./main.go ./handler.go，显式列出所有参与构建的文件 - 避免把
main.go和业务逻辑文件拆到不同子目录又不建子 module；否则go build容易漏文件
真正卡住人的从来不是“怎么装”，而是装完之后那些看似无关的环境变量、模块开关、代理策略之间互相打架。哪怕只错一个 GO111MODULE=off，整个依赖流程就退回十年前。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
