go version能运行但go run报错“no required module provides package”，是因为GO111MODULE=on后未在项目根目录执行go mod init初始化模块；需运行go mod init example.com/myapp生成go.mod，再配置GOPROXY=https://goproxy.cn,direct解决国内依赖下载失败。
Go 环境装不起来，八成卡在环境变量或模块代理上；go version 能跑不代表项目能编译运行，go mod 和 GOPROXY 才是实际开发的第一道门槛。
go version 能输出但 go run 报错：no required module provides package
这是 Go 1.16+ 默认启用模块（GO111MODULE=on）后的典型现象。不是环境没装好，而是当前目录没初始化模块，Go 不知道该从哪找依赖入口。
- 进入项目根目录，执行
go mod init example.com/myapp（模块名可任意，但建议符合域名格式） - 立刻生成
go.mod文件，后续go run、go build才会按模块方式解析导入路径 - 若已有旧项目（如放在
$GOPATH/src/xxx下），必须删掉go.mod并执行go mod init迁移，不能沿用 GOPATH 模式
国内无法下载依赖：get "golang.org/x/net": 403 Forbidden
Go 官方域名在国内被限，golang.org、google.golang.org 下的包（如 golang.org/x/net、google.golang.org/grpc）默认拉不到。
- 必须配置国内代理：运行
go env -w GOPROXY=https://goproxy.cn,direct -
direct是 fallback，确保私有仓库（如公司内网 Git）仍走直连 - 验证是否生效：执行
go env GOPROXY，输出应为https://goproxy.cn,direct - 别手动改
~/.bashrc里的export GOPROXY=...——go env -w会写入go env的配置层，优先级更高且跨 shell 一致
Windows 上安装后 cmd 里找不到 go 命令
不是安装失败，是 PATH 没刷进当前终端会话，或者 MSI 安装时勾选了“仅当前用户”但你用的是管理员 CMD。
立即学习“go语言免费学习笔记（深入）”；
- 先确认安装路径：默认是
C:\Program Files\Go\bin；若自定义了路径，就去对应目录下找go.exe - 打开「系统属性 → 高级 → 环境变量」，在「系统变量」中找到
Path，添加该bin目录完整路径 - 关闭所有已打开的 CMD/PowerShell，**重新打开一个新窗口**再试
go version - 如果用 VS Code，也需重启整个编辑器——它启动时只读取一次系统 PATH
项目能跑但部署失败：找不到 main 函数或 panic: cannot find module providing package
部署时常见错误不是代码问题，而是构建上下文丢失了 go.mod 或工作目录不对。
- 确保部署包里包含
go.mod和go.sum，否则go build在目标机器上会因无模块定义而失败 - 编译命令务必在项目根目录执行：
go build -o myapp ./cmd/myapp（假设入口在cmd/myapp/main.go） - 不要用
go build main.go—— 这会脱离模块上下文，导致相对导入路径（如"myapp/internal/service"）解析失败 - Docker 构建时，
COPY . .后要RUN go build -o /app ./cmd/myapp，而不是RUN go build -o /app main.go
最易忽略的一点：go mod 初始化后，所有 import 路径必须以模块名为前缀（比如 example.com/myapp/internal/config），不能写 "internal/config" —— Go 不认这种“局部路径”，它只认模块路径。这点和 Python 或 Java 完全不同，踩坑的人最多。
