# 11.11 CI/CD 与质量门禁

:::tip 概述
质量门禁收敛为一条命令：`make check`（fmt-check + vet + test-short + check-config）。CI 流水线围绕它组织，辅以前端检查与构建产物验证。
:::

## make check 组成

| 检查 | 内容 |
|---|---|
| fmt-check | gofmt 格式（不合规即失败） |
| vet | go vet 静态分析 |
| test-short | 短测试（跳过外部依赖，无 MySQL 的 CI 可跑） |
| check-config | config.yaml 与 .env.example 键一致性硬检查 |

```bash
make check          # 本地提交前必跑
make.bat check      # Windows
```

本地有 MySQL 时再跑全量 `make test`（集成测试）。

## 推荐 CI 流水线

```text
① 检出代码
② Go 环境 + make check           ← 后端门禁
③ pnpm install + pnpm type:check + pnpm lint:eslint   ← 前端门禁
④ pnpm build（验证产物可构建）
⑤ go build ./...（验证全量编译）
⑥ 产物归档（二进制 + dist/）
⑦ 部署ステージ（测试环境自动、生产人工确认）
```

## 门禁设计原则

| 原则 | 落地 |
|---|---|
| 快 | test-short 不碰外部依赖，门禁分钟级 |
| 硬 | check-config 硬检查配置一致性，杜绝"配置漂移上线" |
| 可本地复现 | CI 跑的就是 make check，无隐藏规则 |
| 生成器友好 | 生成产物同样过 fmt/vet——模板质量受门禁约束 |

## 部署自动化建议

- 测试环境：push 分支自动构建部署
- 生产环境：tag 触发 + 人工审批
- 回滚：保留历史产物，一键切回（systemd 二进制替换 / compose 镜像回退）
- 数据库变更：独立评审的增量脚本步骤，不混在应用部署里

## 相关

- [11.4 后端部署](/zh/deploy/backend.html)
- [11.6 Docker 生产部署](/zh/deploy/docker.html)
- [12.5 Git 提交规范](/zh/standards/git.html)