必须用.msi安装，因其自动注册运行时依赖、设置安全策略并写入注册表；.zip解压易漏ucrt等系统dll，导致cgo交叉编译静默失败。
Go 环境必须用 .msi 安装，别碰 .zip
Windows 上手动解压 .zip 包再配 GOROOT 和 PATH，看似自由，实则极易漏掉 go.exe 依赖的系统 DLL（尤其是 Windows Server 2019+ 的 UCRT 更新），导致后续 go build 在交叉编译或调用 cgo 时静默失败。而官方 .msi 安装器会自动注册运行时依赖、设置安全策略、写入注册表供企业管控工具识别。
- 下载地址只认
https://golang.google.cn/dl/，别用第三方镜像站打包的“精简版” - 安装后必须关掉所有 CMD/PowerShell 窗口——Windows 环境变量刷新不广播，旧终端里
go env显示的仍是空值 -
go version输出中若含unknown（如go1.25.0 unknown/windows/amd64），说明GOROOT被污染，重装 .msi 是最快解法
强一致性协议编译需显式启用 CGO 和条件标签
异地灾备场景下，Raft 或 Multi-Paxos 实现常依赖 clock_gettime(CLOCK_MONOTONIC) 或 getrandom() 等系统调用，这些在纯 Go 模式（CGO_ENABLED=0）下不可用。Golang 默认开启 CGO，但 CI/CD 流水线或容器构建常误设为禁用。
- 编译前确认：
CGO_ENABLED=1 go build -ldflags="-s -w"，否则raft.NewNode可能 panic：“clock source unavailable” - 协议栈代码中用
//go:build raft_linux而非// +build raft_linux（旧语法已废弃），且必须配合go mod tidy自动注入构建约束 - 跨平台时，Windows 下无法使用
epoll或io_uring，需在raft_windows.go中 fallback 到select{} + time.Timer，否则心跳超时判定失效
国内代理必须设 direct 回源，否则私有模块拉取失败
灾备系统常引用内部 GitLab 私有仓库的 Go module（如 gitlab.example.com/infra/raft-ext），若 GOPROXY 未配置 direct，golang 会把私有域名当成公共路径去 goproxy.cn 查，返回 404 后直接中断，不尝试直连。
- 正确命令：
go env -w GOPROXY=https://goproxy.cn,direct，逗号分隔，direct必须在最后 - 验证方式：
go list -m gitlab.example.com/infra/raft-ext@latest，成功则输出模块路径，失败则看 error 是否含 “no matching versions” —— 那就是代理没回源 - 若公司用 Nexus 搭建私有代理，替换为
https://nexus.example.com/repository/goproxy/,direct
灾备切换逻辑必须隔离构建标签，避免测试代码混入生产二进制
开发阶段常在代码里加 //go:build debug_switch 注释来模拟网络分区或强制触发切换，但若构建时未显式排除，这些调试逻辑会打进线上包，造成非预期行为（比如本地测试用的 mock etcd client 连上真实集群）。
- 发布构建务必加
-tags prod：go build -tags prod -o svc-prod . - 所有调试代码文件名必须含
_debug.go后缀，且顶部写//go:build debug_switch，否则go build -tags prod不会跳过它 -
go list -f '{{.ImportPath}}' -tags prod ./... | grep debug可快速扫描是否残留调试模块
真正容易被忽略的是：条件编译标签和 CGO_ENABLED 共同作用时，go build -tags raft_linux 在 CGO_ENABLED=0 下仍会编译通过，但运行时 panic——因为标签只控制 Go 代码可见性，不阻止 cgo 符号链接。必须两者同步检查。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
