Windows新手必须用.msi而非.zip安装包，因.msi自动配置GOROOT和PATH且路径安全，而.zip需手动设置易出错；安装后须关闭所有终端再新开验证，否则环境变量不生效。

直接装 goxxx.windows-amd64.msi 就行，别下 .zip，新手手动配环境变量几乎必错。

为什么必须用 .msi 安装包而不是 .zip

Windows 新手最容易卡在环境变量没生效——.zip 包解压后要手动配置 GOROOT 和 PATH，稍有拼写错误或路径含空格/中文，go version 就报“不是内部或外部命令”。.msi 安装器会自动写入系统级环境变量，且默认路径 C:\Program Files\Go 是安全的。

• 安装完必须关掉所有已打开的 CMD / PowerShell 窗口，新开一个再测
• 如果装到非默认路径（比如 D:\go），确保路径不含中文、空格、括号
• go env 输出里 GOROOT 值应和你安装路径完全一致，不带尾部斜杠

国内拉包失败？三行命令必须立刻执行

不配代理，go mod download 90% 概率超时或卡死，错误信息通常是 proxy.golang.org: i/o timeout 或 Get "https://proxy.golang.org/...": dial tcp: lookup proxy.golang.org: no such host。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 在 CMD 中逐行执行（不用管理员权限）：
  go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.org
• GOPROXY 后的 direct 很关键：它保证当国内镜像没同步新包时，能自动 fallback 到官方源
• 验证是否生效：go env | findstr GOPROXY 应输出完整配置值

go mod 初始化项目时的两个硬性前提

Go 1.16+ 虽然不再强制要求 GOPATH，但项目初始化仍依赖两个隐性条件，缺一不可。

• 当前目录不能是 C:\ 或 D:\ 根目录——必须进到某个子文件夹（如 D:\myproject）再运行 go mod init example.com/hello
• 项目名不能含大写字母或特殊符号，推荐全小写加短横线，例如 example.com/my-api；若用 localhost/hello 也能跑，但后续推送到 Git 会出问题
• 第一次 go run main.go 时，如果提示 no required module provides package ...，说明 go.mod 没生成或路径不对，别硬试，删掉重来

最常被忽略的是：安装完立刻开新终端，以及代理配置后不验证就写代码。这两步跳过，后面所有依赖操作都会无声失败，错误提示却指向别的地方。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！