Go项目运行不依赖环境变量，但GOROOT、GOPATH、GO111MODULE和PATH四者共同决定编译、依赖管理与工具执行是否正常；GOROOT指向Go安装根目录，GOPATH仅用于存放go install生成的二进制及兼容旧项目，GO111MODULE=on是现代项目的硬性前提，PATH必须包含$GOROOT/bin和$GOPATH/bin。
Go 项目本身不依赖环境变量运行，但 GOROOT、GOPATH、GO111MODULE 和 PATH 这四个变量直接决定你能否正常编译、下载依赖、运行工具命令——尤其在宿主环境（非容器）下手动编译时，错配任何一个都可能表现为 command not found、cannot find package 或意外退回到 GOPATH 模式。
go version 能跑不代表环境就对了
很多用户执行 go version 成功就以为配置完成，其实这只是说明 PATH 包含了 $GOROOT/bin；但漏掉 $GOPATH/bin 会导致 go install 的二进制（比如 gopls、gotestsum）无法在终端直接调用；漏掉 GO111MODULE=on 则可能在有 go.mod 的项目里仍尝试读取 $GOPATH/src，报错 no required module provides package。
- 验证方式不是只跑
go version，而是必须执行：go env GOROOT GOPATH GO111MODULE和echo $PATH | grep -E "(go|bin)" - Windows 用户注意：
%GOPATH%\bin必须加到系统 PATH，不能只加在用户 PATH（某些 IDE 启动终端会忽略用户级 PATH） - macOS / Linux 用户若用 zsh，检查的是
~/.zshrc，不是~/.bash_profile；改完记得source ~/.zshrc
GOROOT 和 GOPATH 的实际分工已经很清晰
GOROOT 是 Go 安装根目录，只用于存放编译器、标准库和 go 命令本身；GOPATH 在模块时代仅剩两个用途：存放 go install 生成的可执行文件（即 $GOPATH/bin），以及兼容老项目（$GOPATH/src）。新项目完全不需要把代码放在 GOPATH 下。
- 如果你用官方
.msi（Windows）或.pkg（macOS）安装，GOROOT通常已自动设好，不用再手动 export -
GOPATH可以保持默认（$HOME/go），也可以自定义，但务必确保$GOPATH/bin在PATH中，否则go install github.com/xxx/cli@latest装完也找不到命令 - 多个
GOPATH路径（用:或;分隔）极少必要，反而容易让go get下载包时行为不可控
GO111MODULE=on 是现代项目的硬性前提
Go 1.16+ 默认启用模块，但部分旧 shell 配置或 CI 环境仍可能继承 auto 或 off。一旦为 off，即使项目根目录有 go.mod，go build 也会忽略它，转而尝试从 $GOPATH/src 解析导入路径，导致构建失败。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 推荐统一用
go env -w GO111MODULE=on写入全局配置，比 shell export 更可靠（不受 shell 类型或配置文件加载顺序影响） - 如果项目必须兼容 GOPATH 模式（极少见），才临时设为
off；auto不推荐，因为它的触发逻辑是“当前目录或父目录存在 go.mod”，容易因 pwd 错误被绕过 - 国内用户顺手加上代理：
go env -w GOPROXY=https://goproxy.cn,direct，避免go mod download卡住
PATH 配错是最常被低估的故障点
几乎所有“命令找不到”类问题，根源都在 PATH 缺少关键 bin 目录。尤其容易忽略的是：$GOPATH/bin 不是可选，而是 go install 工具链的交付出口；没它，你就得每次用完整路径调用，比如 $HOME/go/bin/gopls。
- 正确写法（Linux/macOS）：
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH——$GOROOT/bin必须在前，避免其他同名go命令干扰 - Windows 用户注意：
%GOROOT%\bin和%GOPATH%\bin都要加进 PATH，且不能带尾部反斜杠（C:\Go\bin\是错的，应为C:\Go\bin） - 验证是否生效：运行
which go（macOS/Linux）或where go（Windows），输出应为$GOROOT/bin/go；再运行which gopls，应指向$GOPATH/bin/gopls
真正麻烦的不是变量多，而是它们之间有隐含依赖：PATH 错了，go 命令都启动不了；GOROOT 错了，go env 就读不到真实安装路径；GO111MODULE 没开，模块就形同虚设。每个变量都要单独验证，不能靠“能跑 hello world”来蒙混过关。
