这份文档旨在为团队内部的技术选型和新人培训提供参考，涵盖 Go 语言官方标准库和社区主流第三方库的完整概览。
第一部分：Go 官方标准库 (Standard Library)
简介：Go 语言奉行 "Batteries Included"（自带电池）哲学，标准库极其丰富，且保证向后兼容。除特殊需求外，优先使用标准库。
官方文档：pkg.go.dev/std
1. 核心与基础 (Core & Foundation)
这些是写任何 Go 程序几乎都会用到的基石。
| 包名 (Package) | 功能描述 | 典型应用场景 |
|---|
fmt | 格式化 I/O | 打印日志 Println，格式化字符串 Sprintf。 |
time | 时间与日期处理 | 获取当前时间、定时器 Ticker、时间格式化、计算耗时。 |
os | 操作系统接口 | 打开文件、读取环境变量、进程操作、信号处理。 |
errors | 错误处理 | 创建错误 New，包装错误 Wrap (Go 1.13+)。 |
context | 上下文控制 (核心) | 控制 Goroutine 的超时、取消，跨 API 传递 TraceID。 |
flag | 命令行参数解析 | 解析启动参数（如 ./app -port 8080）。 |
log | 基础日志 | 简单的日志打印（生产环境通常用第三方库替代）。 |
2. 数据类型与转换 (Data & Types)
处理数字、字符串、正则和集合。
| 包名 (Package) | 功能描述 | 典型应用场景 |
|---|
strconv | 字符串转换 | String 与 Int/Bool/Float 互转 (Atoi, Itoa)。 |
strings | 字符串操作 | 切割 Split、拼接 Join、查找 Contains、替换。 |
bytes | 字节切片操作 | 高性能的字节流处理（类似 strings 但针对 []byte）。 |
sort | 排序 | 对切片进行排序。 |
slices | 切片泛型操作 (Go 1.21+) | 包含 Reverse (反转), Contains 等现代切片工具。 |
regexp | 正则表达式 | 文本匹配和替换。 |
math | 数学运算 | 绝对值、三角函数、最值等。 |
3. 网络编程 (Networking - Go 的王牌)
Go 在云原生领域的统治力源于此。
| 包名 (Package) | 功能描述 | 典型应用场景 |
|---|
net/http | HTTP 客户端与服务端 | 构建 Web Server，发送 HTTP 请求。 |
net | 底层网络接口 | TCP/UDP Socket 编程，IP 地址解析。 |
net/url | URL 解析 | 解析网址参数，URL 编码/解码。 |
encoding/json | JSON 处理 | 结构体与 JSON 字符串互转，API 开发必备。 |
html/template | HTML 模板 | 服务端渲染 HTML 页面（防注入）。 |
4. 系统与并发 (System & Concurrency)
底层控制与高性能并发工具。
| 包名 (Package) | 功能描述 | 典型应用场景 |
|---|
sync | 同步原语 | 互斥锁 Mutex，等待组 WaitGroup，单次执行 Once。 |
sync/atomic | 原子操作 | 无锁编程，高性能计数器。 |
io / io/ioutil | I/O 接口 | 定义读取器/写入器标准 (Reader/Writer)。 |
path/filepath | 文件路径处理 | 跨平台处理路径（自动处理 Windows \ 和 Linux /）。 |
runtime | 运行时系统 | 控制协程调度，触发 GC，获取调用堆栈。 |
5. 加密与安全 (Crypto & Security)
生产级的加密库。
| 包名 (Package) | 功能描述 | 典型应用场景 |
|---|
crypto/* | 加密算法集合 | crypto/md5, crypto/sha256, crypto/aes。 |
crypto/tls | TLS/SSL 协议 | 实现 HTTPS，证书验证。 |
crypto/rand | 强随机数 | 生成密码学安全的随机数。 |
6. 测试与工具 (Testing)
| 包名 (Package) | 功能描述 | 典型应用场景 |
|---|
testing | 测试框架 | 单元测试 (TestXxx)，基准测试 (BenchmarkXxx)。 |
database/sql | SQL 通用接口 | 定义数据库连接池、事务接口（不含驱动）。 |
embed | 文件嵌入 (Go 1.16+) | 把静态文件打包进二进制文件。 |
第二部分：官方扩展库 (Official Extended Library)
简介：由 Go 官方团队维护，作为标准库的补充，路径以 golang.org/x/ 开头。
| 扩展库 | 功能描述 |
|---|
golang.org/x/net | 补充网络功能，如 WebSocket, HTTP/2 高级功能, DNS 扩展。 |
golang.org/x/crypto | 补充加密算法，如 SSH, Bcrypt (密码哈希), OpenPGP。 |
golang.org/x/text | 强大的国际化支持，文本编码转换 (GBK 转 UTF8) 。 |
golang.org/x/sync | 高级并发工具，如 errgroup (并发任务组，这一条非常常用)。 |
第三部分：社区主流第三方库 (De Facto Standards)
简介：虽非官方，但已成为行业事实标准，大厂都在用。
1. Web 框架 (Web Frameworks)
| 库名 | 简介 | 适用场景 |
|---|
| Gin | github.com/gin-gonic/gin | 最流行。高性能，类 Express/Koa 风格，中间件丰富。 |
| Echo | github.com/labstack/echo | 代码优雅，文档极佳，性能与 Gin 相当。 |
| Fiber | github.com/gofiber/fiber | 极致性能，追求零内存分配，API 类似 Express。 |
2. 数据库与 ORM (Database)
| 库名 | 简 介 | 适用场景 |
|---|
| GORM | github.com/go-gorm/gorm | 最流行。功能全，上手快，支持 MySQL/PG 等主流 DB。 |
| Ent | entgo.io/ent | Facebook 出品。Schema 即代码，类型安全，适合大项目。 |
| sqlx | github.com/jmoiron/sqlx | database/sql 的增强版。不做 ORM，只做 SQL 简化映射，适合喜欢写原生 SQL 的人。 |
| go-redis | github.com/redis/go-redis | Redis 官方推荐的 Go 客户端。 |
3. 微服务与 RPC (Microservices)
| 库名 | 简介 | 适用场景 |
|---|
| gRPC-Go | google.golang.org/grpc | Google 官方出的 gRPC 库。云原生通信标准。 |
| go-zero | github.com/zeromicro/go-zero | 国内最火的微服务全家桶。自带代码生成工具，内置治理能力。 |
| Kratos | github.com/go-kratos/kratos | B站开源。模块化设计，DDD 驱动，适合大型架构。 |
4. 配置与工具 (Configuration & Utilities)
| 库名 | 简介 | 适用场景 |
|---|
| Viper | github.com/spf13/viper | 配置管理神器。支持 JSON/YAML/环境变量/远程配置中心。 |
| Cobra | github.com/spf13/cobra | CLI 工具神器。K8s、Docker 的命令行都是用它写的。 |
| Zap | github.com/uber-go/zap | Uber 开源的高性能日志库。比标准库 log 快且结构化。 |
| Wire | github.com/google/wire | Google 出的依赖注入工具（编译时生成）。 |
| Testify | github.com/stretchr/testify | 测试断言库。提供 assert.Equal 等语法糖。 |
| UUID | github.com/google/uuid | 生成 UUID。 |
附录：选型建议
根据不同的项目类型，推荐以下技术栈组合：
| 项目类型 | 推荐技术栈 |
|---|
| Web API | Gin + GORM + Viper + Zap |
| 微服务 | go-zero 或 Kratos |
| 命令行工具 | Cobra + Viper |
| 简单脚本 | 全部使用标准库 (fmt, net/http, os, strings) |
选型原则
- 优先标准库：Go 标准库质量极高，能满足大部分需求
- 明确需求再选型：不要为了用框架而用框架
- 关注社区活跃度：选择 Star 数多、更新频繁的库
- 考虑学习成本：团队熟悉度也是重要因素