下面给你一份“能落地、不喊口号”的 Go 半老系统渐进优化手册——
既照顾“代码还在跑、不能停”，又能让团队每天敢改、敢上线。按“先止血 → 再松绑 → 后重构”三个阶段推进，每个阶段都给出可以直接 copy 的脚本/命令/代码片段，拿来就能跑。
---
阶段 0：现状快照（1 天搞定）
1. 一次性指标# 统计 Go 版本、依赖、代码规模
go version
find . -name "*.go" | xargs wc -l | tail -1
go list -m -json all | jq -r '.Path+"@"+.Version' | sort > deps.txt
# 静态坏味道
go install github.com/dominikh/go-tools/cmd/staticcheck@latest
staticcheck ./... > staticcheck.txt
# 单测覆盖率
go test -race -coverprofile=cover.out ./...
go tool cover -func=cover.out | grep total
把以上数字贴到 README，作为“ baseline ”，后面每两周跑一回，用数据说话。
---
阶段 1：止血（让代码先“敢改”）—— 2 周
目标：不碰业务，先让“编译 → 单测 → 跑起来”从 30 分钟降到 5 分钟。
1. 统一工具链
项目根目录放 tools.go：//go:build tools
package tools
import (
_ "github.com/dominikh/go-tools/cmd/staticcheck"
_ "github.com/golangci/golangci-lint/cmd/golangci-lint"
_ "github.com/vektra/mockery/v2"
)
然后 go mod tidy 会把工具锁进 go.sum，所有人版本一致。
2. 本地 Git Hook 强制 fmt/vet# .git/hooks/pre-commit （给团队每人跑一次即可）
#!/bin/sh
exec 1>&2
set -e
go fmt ./...
go vet ./...
golangci-lint run --new-from-rev=HEAD~1
老代码太大可 --new-from-rev=origin/main，只拦新增脏代码。
3. 把“能编译”写进 CI
GitHub Actions / GitLab CI 只需 30 行，先跑 go build ./cmd/... → go test -race ./...，保证 MR 红红绿绿肉眼可见。
4. 大单体拆“编译边界”
目录里一堆 package main 互相 import？先加 // +build 标签拆出：- cmd/old-api
- cmd/old-worker
让 go build ./cmd/... 能并行，本地增量编译从 2 分钟降到 15 秒。
---
阶段 2：松绑（把“改不动”变“可测试”）—— 4 周
目标：核心函数能写单测，不用起 MySQL/Redis。
1. 先圈最赚钱的核心链路
用 pprof 跑 3 天线上 CPU：import _ "net/http/pprof"
go func() { log.Println(http.ListenAndServe("0.0.0.0:6060", nil)) }()
拿到 top10 函数，只对这 10 个文件动刀，ROI 最高。
2. 快速抽象接口，不拆库
原来代码直接 sql.DB.Exec / redis.Client.Get？
抽出 20 行 interface 放 internal/repo 目录：type OrderRepo interface {
Get(ctx context.Context, id int64) (*Order, error)
Save(ctx context.Context, o *Order) error
}
老代码继续用 mysqlOrderRepo，测试用 fakeOrderRepo 直接 map[int64]*Order，5 分钟就能写表驱动单测。
3. 生成 mock，不写手写mockery --name=OrderRepo --output=internal/mocks
测试里 go:generate 一行，后面 mock 自动生成，团队无门槛。
4. 覆盖率门禁
只对上面 top10 函数设 80% 覆盖率，其余文件先不管，用go test -coverpkg=./internal/... ./internal/order/...
慢慢把“冰山”往上提。
---
阶段 3：重构（真正“想改就改”）—— 3 个月起
1. 领域服务层沉淀
把 internal/order/service.go 里只做“纯内存计算 + 接口调用”的业务规则拢出来，数据库事务沉到 repo，后面想换 gORM 还是 ent 都随意。
2. 渐进式切分模块
用 Go 1.20+ workspace 模式，先把 internal/order 拆成 /order 子模块：go work init
go work use . ./order
能独立 tag，能独立跑单测，但还在一个仓库，运维无感。
3. 引入 wire/uber-fx 做依赖注入
把 main 函数里 100 行 NewXXX 手工初始化改成 wire 生成，后面换组件只改 wire.go 一个文件。
4. 灰度发布兜底
每个重构函数加开关：var oldFunc = featureflag.Bool("use_old_price_calc")
if oldFunc { ... } else { ... }
用 Consul/env 秒级切换，先 1% 流量，一晚没问题再全量。
---
配套工具清单（全部开源，直接 go install）
- 静态坏味道：staticcheck / golangci-lint
- 接口 mock：mockery
- 依赖注入：wire 或 uber-fx
- 灰度开关：open-feature/go-sdk（或自写 consul 布尔）
---
落地节奏表
周 目标 产出
0 快照 baseline 数字 + CI 绿灯
1-2 止血 本地 pre-commit + 增量编译 <30s
3-6 松绑 top10 函数 80% 单测，核心链路可本地跑
7-18 重构 领域层独立，子模块 workspace，灰度上线
---
最后一句话
老系统优化不是“一口气重写”，而是“先让测试跑赢，再让代码松耦合，最后才动大刀子”。
按上面三阶段小步快跑，每周都能上线，老板看到指标变好，团队也有成就感，代码自然就“从不敢动”变成“想改就改”。祝早日脱离泥潭。
