go环境配置核心是goroot必须指向真实安装路径、go111module必须为on；需确认系统架构（amd64/arm64）下载匹配安装包，验证go version输出架构一致；goroot一般无需手动设置，gopath现代开发中非必需；必须启用go modules并配置国内代理（如goproxy.cn）及gosumdb校验。

go 环境搭得不对，后续所有 go run、go build、go mod 都会出问题。不是版本装不上，就是模块拉不下来，或者 go install 的工具找不到——核心就两点：GOROOT 必须指向真实安装路径，GO111MODULE 必须为 on，其余都是细节。

确认系统架构再下载安装包

很多编译失败或命令报错，源头其实是装错了架构版本。别直接点“Download”就下，先看清楚自己机器是 amd64 还是 arm64（M1/M2/M3 Mac、树莓派、AWS Graviton 实例都属于后者）。

• Linux/macOS 执行 uname -m：输出 x86_64 → 选 linux-amd64.tar.gz 或 darwin-amd64.pkg；输出 aarch64 或 arm64 → 必须选带 arm64 后缀的包
• Windows 用户注意：新版 PowerShell 默认是 64 位，但某些旧版 CMD 可能仍跑在 32 位兼容层，建议统一用 PowerShell 验证
• 装完立刻验证：go version 输出里必须包含你的实际架构，比如 linux/amd64 或 darwin/arm64，否则二进制不匹配，后续任何编译都会静默失败或 panic

GOROOT 和 GOPATH 不要混着设

GOROOT 是 Go 安装位置，GOPATH 是你放代码的老式工作区——但现代开发中，GOPATH 已非必需，硬设反而容易冲突。

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

• GOROOT 一般不用手动设：Linux/macOS 解压到 /usr/local/go、Windows 装在 C:\Program Files\Go，安装程序或 tar 命令会自动识别；如果手动改过路径，必须确保 $GOROOT/bin 在 PATH 里，且 go env GOROOT 输出和物理路径一致
• GOPATH 建议只在需要 go install 第三方工具（如 gopls、dlv）时才显式设置；若不设，默认是 $HOME/go，但它的 src 子目录已不再用于存放你自己的项目（那是 Go Modules 的事）
• 常见坑：export GOPATH=$PWD 这种写法会导致 go mod init 失败，因为 Go 会拒绝在 GOPATH 内部初始化 module；正确做法是离开任意 GOPATH 目录后再建项目

Go Modules 必须启用且代理要配对

Go 1.16+ 默认开启模块模式，但国内不配代理，go mod download 会卡死或超时，连 go list -m all 都跑不动。

• 执行 go env -w GO111MODULE=on 强制启用（即使你用的是 1.20+，也建议显式写一次，避免被 shell 环境变量覆盖）
• 代理推荐两个组合：https://goproxy.cn,direct（稳定、中文文档全）或 https://proxy.golang.org,direct（官方，但国内不稳定）；阿里云镜像 https://mirrors.aliyun.com/golang/ 只提供安装包，不支持模块代理
• 校验和数据库也要同步设：go env -w GOSUMDB=sum.golang.org；如果公司内网禁外网，可设为 off，但必须清楚后果：跳过 checksum 校验，存在依赖投毒风险
• 验证是否生效：go env GOPROXY GOSUMDB GO111MODULE 三者输出应全部符合预期，缺一不可

标准编译流程：从 go mod init 到 go build

一个干净的 Go 项目，不依赖 GOPATH，只靠 go.mod 文件驱动整个生命周期。

• 新建空目录，执行 go mod init example.com/myapp（模块名不必真实可访问，但需符合域名格式，避免纯数字或下划线）
• 写好 main.go 后，直接 go run . 运行；它会自动解析 go.mod、下载缺失依赖、编译并执行——无需 go get 预装
• 生成可执行文件：go build -o myapp .；注意末尾的 . 表示当前目录，漏掉会报 no Go files in
• 交叉编译（比如在 macOS 上编译 Linux 二进制）：GOOS=linux GOARCH=amd64 go build -o myapp-linux .；GOOS 和 GOARCH 必须拼写准确，大小写敏感，GOARCH=arm64 不能写成 ARM64

真正容易被忽略的是：每次 go mod 操作（包括 go run 隐式触发的）都会读取 go.sum 并校验哈希，一旦你手动编辑过 go.mod 或删过 go.sum，下次 go build 就可能因校验失败而中断——这不是网络问题，是完整性保护机制在起作用。

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