用途:在改动 Go 源码、模块、构建流水线、测试、加密代码、HTTP 栈或平台集成前,先查阅对应主题参考,避免沿用旧默认值或兼容开关。
主要能力:提供按主题划分的参考索引,涵盖语言与核心(函数迭代器、模板、语法、错误、反射、时间、正则)、工具模块与测试(模块、工作区、go 命令、vet、缓存、源码分析、测试、性能分析)、运行时与可观测性(GC、调度、trace、崩溃恢复、清理、堆布局、指标)、文件系统数据与编码(rooted 文件系统、链接、tar、JSON v2、JPEG、Windows 句柄、fstest)、网络与 HTTP(DNS、HTTP 协议、重定向、反向代理、CSRF、URL 解析、MPTCP)、加密 TLS 与 X.509(FIPS、随机性、签名、KEM 与 HPKE、RSA、X.509、SHA-3、TLS 默认值)、构建链接与平台(Cgo、链接器行为、构建 ID、进程句柄、WASI、架构配置、端口、引导下限)。
必要用法:使用前先查对应主题文件;涉及破坏性变更时按参考更新已移除或取代的 API,例如用 go doc 替代 go tool doc,用 Rewrite 替代 ReverseProxy.Director,用 crypto/cipher 构造器替代 aes.NewCipher 具体块方法,用 AEAD 替代 OFB/CFB,迁移 PKCS #1 v1.5 加密与 ECDSA big.Int 字段,替换 AST 包合并 API 与 parser.ParseDir。注意更严格行为:解引用前检查错误、url.Parse 拒绝歧义冒号主机、time.Parse 拒绝越界时区偏移、RSA 拒绝小于 1024 位密钥、X.509 拒绝 SHA-1 签名、随机性注入需用 testing/cryptotest.SetGlobalRandom。默认值变化包括 Green Tea GC、GOMAXPROCS 观察 cgroup、MPTCP 默认启用、后量子混合 TLS 默认启用、ServeMux 尾斜杠重定向改用 307、go mod init 选择较旧语言版本、go build -asan 默认泄漏检测、默认输出 DWARF 5 与原生构建标识。
适用场景:Go 项目升级、兼容性排查、加密与 TLS 配置、HTTP 与网络行为调整、跨平台构建。
限制:实验性包(jsonv2、simd、runtimesecret、goroutineleakprofile)不保证可移植或兼容;部分 GODEBUG 开关计划被忽略或移除;具体平台限制需查阅对应参考文件。