Go 1.16+ 默认启用 go mod，无需手动配置 GOPATH；常见问题包括 PATH 未生效、GO111MODULE=off、go.mod 路径与 import 不一致、goctl 需单独安装并配置 GOPATH/bin 到 PATH。
Go 环境现在根本不用手动配 GOPATH，装完就能写代码——只要你用的是 Go 1.16+（2026 年默认已是 Go 1.22），go mod 已是默认行为，GOPATH 只在极少数遗留项目或交叉编译时才需显式干预。
go version 报错：command not found 或 no such file
这不是 Go 没装好，而是 PATH 没生效。macOS/Linux 下常见于 shell 配置文件没 reload，Windows 则多因安装时勾选了“Add to PATH”但未重启终端。
- macOS/Linux：检查
~/.zshrc或~/.bash_profile是否追加了export PATH=$PATH:/usr/local/go/bin（或你自定义的安装路径），然后执行source ~/.zshrc - Windows：右键“此电脑”→属性→高级系统设置→环境变量→确认
Path中包含类似C:\Program Files\Go\bin的条目，且没有拼写错误（注意反斜杠和空格） - 验证方式不是双击安装包图标，而是新开一个终端窗口，再跑
go version；如果还报错，直接运行/usr/local/go/bin/go version（Linux/macOS）或C:\Program Files\Go\bin\go.exe version（Windows）看是否能出结果——能出说明路径对，只是没进PATH
go mod init 失败：‘go: modules disabled by GO111MODULE=off’
这是 Go 1.12+ 默认启用模块机制后，仍被旧脚本或全局环境变量强行关闭导致的。现代项目必须用模块，关掉它等于拒绝依赖管理。
- 先查当前状态：
go env GO111MODULE，若输出off，就立刻执行go env -w GO111MODULE=on - 不要在项目目录里手动设
GO111MODULE=off，除非你在维护一个 2018 年前的 GOPATH-only 项目（现在极少） -
go mod init myapp必须在空目录下首次运行，且目录名不能含大写字母或特殊符号（如MyApp或my-app都可能引发后续导入路径问题）
go run main.go 提示 ‘cannot find module providing package’
不是代码错了，是模块根目录没识别到。Go 不靠文件路径找包，而靠 go.mod 文件所在位置定义模块边界。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 确保
main.go和go.mod在同一级目录，且go.mod里module行写的路径能匹配你实际 import 的路径（例如module example.com/hello，那其他文件 import 就得写"example.com/hello/utils"） - 如果刚建项目就报这个错，大概率是
go mod init没成功生成go.mod，或者你误把main.go放到了子目录里 - 别用 IDE 自带的“新建 Go 文件”功能直接建
main.go，先用终端mkdir hello && cd hello && go mod init hello，再写代码
goctl 无法使用：command not found
goctl 不是 Go 自带命令，是 Go-Zero 生态的 CLI 工具，必须单独安装，且依赖 Go 的 $GOPATH/bin（即使不用 GOPATH，也要有该目录并加入 PATH）。
- 先确认
$GOPATH是否已设（go env GOPATH），若为空，执行go env -w GOPATH=$HOME/go（macOS/Linux）或go env -w GOPATH=%USERPROFILE%\go（Windows） - 安装：
go install github.com/zeromicro/go-zero/tools/goctl@latest，完成后检查$GOPATH/bin下是否有goctl文件 - Windows 用户特别注意：
%GOPATH%\bin必须在PATH中，且不能有中文路径；若仍找不到，尝试用goctl -v的绝对路径调用（如%USERPROFILE%\go\bin\goctl.exe -v）
真正卡住人的从来不是语法，而是环境变量改了没 reload、go.mod 路径和 import 不一致、或者把第三方工具当成内置命令——这些点不手动验证一遍，光看教程永远在循环重装。
