必须先执行arch确认芯片架构：arm64为apple silicon，amd64为intel；仅下载darwin-arm64.pkg并验证go version含darwin/arm64，否则卸载重装；禁用rosetta转译，因其导致build产物为x86架构无法原生运行。

确认当前芯片架构再装 Go，别信 Rosetta 自动转译

Apple Silicon（M1/M2/M3）和 Intel Mac 的 go 二进制完全不兼容。装错包会导致 go version 输出 darwin/amd64，或直接报 cannot execute binary file。Rosetta 可能让命令跑起来，但 go build 产出的是 x86 架构二进制，无法原生运行在 ARM 设备上。

终端执行：arch —— 输出 arm64 就是 Apple Silicon；输出 amd64 是 Intel。Linux 云服务器或虚拟机则用 uname -m：x86_64 对应 amd64，aarch64 或 arm64 对应 arm64。

必须下载匹配的安装包：

• Mac Apple Silicon → go*.darwin-arm64.pkg（官网或清华镜像）
• Mac Intel → go*.darwin-amd64.pkg
• Linux x86_64 → go*.linux-amd64.tar.gz
• Linux ARM64 → go*.linux-arm64.tar.gz

安装后立刻验证：go version 输出里必须含 darwin/arm64、linux/amd64 等对应标识。否则删掉 /usr/local/go 重装。

跨架构调试必须用 dlv，且平台严格匹配

dlv（Delve）是 Go 唯一稳定支持跨平台远程调试的工具。它不能靠包管理器“一键装好”——brew install delve 在 macOS 上常缺失符号调试能力，apt install golang-delve 在 Ubuntu 上版本滞后且不支持 headless 模式。

正确安装方式：go install github.com/go-delve/delve/cmd/dlv@latest。安装后必须运行：dlv version，确认输出含 Build ID 且无 permission denied 或 cannot find symbol table 错误。

关键约束：

Golang Uber Dig

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

下载

• macOS 用户需在「系统设置 → 隐私与安全性 → 全盘访问」中勾选终端或 VS Code
• WSL2 中必须在 Linux 子系统内安装并运行 dlv，Windows 侧调用会失败
• dlv serve 启动的服务端与目标程序的 GOOS/GOARCH 必须一致（例如服务端是 linux/arm64，被调试程序也得是 linux/arm64）
• 构建时加 -gcflags="-N -l"，否则优化会剥离调试符号，断点失效

交叉编译要关 CGO，除非你真有对应 C 工具链

Go 原生支持 GOOS 和 GOARCH 跨平台编译，但一旦启用 CGO_ENABLED=1（默认开启），就必须提供目标平台的 C 编译器和库。比如从 macOS arm64 编译 Linux amd64 二进制，若没配 CC_x86_64_unknown_linux_gnu，就会报 exec: "x86_64-linux-gnu-gcc": executable file not found。

最简方案是禁用 CGO：

• CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app-linux-amd64 .
• 适用于纯 Go 项目（不调 C 库、不依赖 net 的 DNS 解析、不用 os/user 等）

若必须用 CGO（如调用 OpenSSL、SQLite）：

• Linux ARM64 目标 → 安装 gcc-aarch64-linux-gnu，设 CC_aarch64_unknown_linux_gnu=aarch64-linux-gnu-gcc
• LoongArch64 目标 → Go ≥ 1.20 + gcc-loongarch64-linux-gnu 工具链 + CC=loongarch64-linux-gnu-gcc GOARCH=loong64
• Windows 目标（从 macOS/Linux 编译）→ 需 MinGW-w64 工具链，且 CGO_ENABLED=1 时链接器易出错，建议优先用 CGO_ENABLED=0

多架构开发环境别混用 GOPATH，模块才是唯一事实源

Go 1.16+ 默认启用模块模式，GOPATH 不再存放源码，只管 go install 生成的可执行文件（即 $GOPATH/bin）。但很多人仍习惯把项目放 $GOPATH/src 下，结果在不同芯片机器间同步代码时，go mod download 因缓存路径或校验差异失败。

正确做法：

• 所有新项目直接在任意路径初始化：go mod init example.com/myapp（域名只是命名空间）
• 依赖统一走 go.mod，不依赖 GOPATH 结构
• go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct 解决国内拉包慢
• go env -w GOSUMDB=off 仅限测试环境；生产环境保留校验，改用代理透传 sum.golang.org

真正容易被忽略的是：同一项目在 Apple Silicon 和 Intel Mac 上分别 go build，产出二进制架构不同，但 go mod vendor 或 go list -m all 输出完全一致——模块机制本身是架构无关的，问题永远出在 CGO、工具链或环境变量泄漏上。

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