分享自己常用的 Go 技术栈：不炫技，但稳得一批！

Go 项目不需要花里胡哨的框架，但选对工具链，能让你少加班、多摸鱼。

一、为什么我们不用“最简标准库”？

Go 社区有个“迷思”：“能用标准库就别用第三方库！”

听起来很极客，但现实是——
你写个配置管理要手动解析 YAML + 环境变量 + 命令行参数？
你写个 CLI 工具要手搓 flag 解析和子命令？
你写个 Web 服务要自己处理 panic、CORS、日志、错误码？

醒醒，我们不是在参加“最小依赖挑战赛”。
我的目标是：快速交付、稳定运行、方便维护。

于是，我决定分享一套“稳如老狗”的 Go 技术栈，今天全盘托出！

---

二、核心工具链：各司其职，配合默契

1️⃣ Viper：配置管理，再也不怕“环境爆炸”

viper.SetDefault("port", 8080)
viper.AutomaticEnv() // 自动读取 PORT=9090 这类环境变量
port := viper.GetInt("port")

✅ 优势：

• 支持 YAML/TOML/JSON/Env/Flag 多源合并
• 自动优先级：命令行 > 环境变量 > 配置文件 > 默认值
• 不用再写 os.Getenv("DB_HOST") + 手动类型转换

🧠 场景：微服务部署到不同环境（dev/staging/prod），一套代码，零配置硬编码。

---

2️⃣ Cobra + Viper：CLI 工具的黄金搭档

想写 myapp serve --port 8080 这种专业命令行工具？
Cobra 给你结构化命令、子命令、flag 解析，Viper 负责配置注入。

var serveCmd = &cobra.Command{
	Use:   "serve",
	Short: "Start the HTTP server",
	RunE: func(cmd *cobra.Command, args []string) error {
		port := viper.GetInt("port")
		// 启动服务...
		return nil
	},
}

✅ 小技巧：用 RunE 而不是 Run，只在参数校验失败时返回 error，执行错误只记录不中断进程。

🧠 场景：运维脚本、开发工具、内部 CLI 平台——让用户觉得“这工具很专业”。

---

3️⃣ Uber Fx：依赖注入 + 生命周期管理，告别“面条式 main”

Go 很多人抗拒 DI，觉得“太重”。但当你有 20 个服务互相依赖时，手动 NewX(NewY(NewZ(...))) 就会崩溃。

Fx 用声明式方式自动组装依赖，并管理启动/关闭顺序：

fx.New(
	fx.Provide(NewMux, NewHTTPServer),
	fx.Invoke(StartHTTPServer),
).Run()

✅ 优势：

• 构造函数自动注入依赖（基于类型）
• fx.Lifecycle 统一处理 goroutine 启停、优雅关闭
• 测试时轻松 mock 接口

🧠 场景：中大型应用、需要清晰模块边界、支持单元测试。

---

4️⃣ Echo：轻量但全能的 Web 框架

Go 标准库 net/http 很强，但重复写 middleware、panic recovery、CORS 太累。

Echo 提供：

• 路由分组
• 内置中间件（logger, recovery, CORS）
• 请求绑定 & 验证
• 统一错误处理

配合自定义 CommonErrorHandler，还能把数据库错误转成用户友好的 HTTP 响应：

if errors.Is(err, gorm.ErrRecordNotFound) {
	c.JSON(404, map[string]string{"error": "resource not found"})
}

✅ 优势：比 Gin 更结构化，比标准库更省力。

🧠 场景：API 服务、内部平台后端、需要统一错误码体系。

---

5️⃣ GORM：我们为何“顶风作案”用 ORM？

Go 圈很多人说：“别用 ORM，手写 SQL 才纯粹！”

但我们发现：当业务模型超过 5 个实体，不用 ORM 反而更混乱。

GORM 让我们：

• 用 struct 定义表结构
• 自动处理关联（HasOne/HasMany）
• 使用 Hook 做软删除、审计日志
• 通过 Repository 模式封装，避免泄露细节

💡 关键原则：GORM 只在 Repository 层使用，上层只依赖接口。

✅ 优势：开发快、模型清晰、迁移方便（尤其配合 PostgreSQL）。

---

6️⃣ Testify：让测试不再“将就”

• testify/mock：自动生成 mock 实现，测试 service 层超轻松
• testify/suite：共享 setup/teardown，组织复杂测试用例

配合 Fx 的接口依赖，单元测试覆盖率轻松拉满。

---

7️⃣ Asynq：背景任务交给 Redis

发邮件、同步数据、跑报表……这些不该阻塞请求。

Asynq 基于 Redis，提供：

• 任务入队/消费
• 自动重试 + 延迟执行
• 失败告警

🔜 未来可能切换到 River（更现代的设计），但 Asynq 目前稳如泰山。

---

8️⃣ Zerolog：零分配结构化日志

log.Ctx(ctx).Info().Str("user_id", "123").Msg("User logged in")

输出 JSON，直接喂给 Loki / Datadog / ELK。

✅ 优势：

• 性能极高（zero-allocation hot path）
• 上下文透传（request ID、trace ID 自动携带）
• 开发环境彩色输出，生产环境机器可读

---

三、组合起来：一个真实项目骨架

main.go
├── cmd/
│   └── root.go          # Cobra 入口
├── internal/
│   ├── config/          # Viper 初始化
│   ├── server/          # Echo + HTTP handlers
│   ├── service/         # 业务逻辑（依赖 repository 接口）
│   ├── repository/      # GORM 实现
│   └── worker/          # Asynq 任务处理器
└── pkg/
    └── di/              # Fx 模块组装

启动流程：

1. Cobra 解析命令
2. Viper 加载配置
3. Fx 注入所有依赖
4. Echo 启动 HTTP 服务
5. Asynq 启动后台 worker
6. Zerolog 全局日志追踪

---

四、结语：工具不是越多越好，而是“刚刚好”

这套栈没有炫技，没有最新潮的玩具，
但它经过多年生产验证，帮我们：

• 快速迭代
• 降低 bug 率
• 提升新人上手速度
• 让 on-call 不再噩梦

Go 的哲学不是“少即是多”，而是“清晰胜于聪明”。

---