边走边聊 Python 3.8：Chapter 21 CI/CD 自动化测试

Chapter 21：CI/CD 自动化测试

自动化测试不是为了机器，而是为了你能睡得更安稳。本章将带你构建一个可自动运行测试、自动构建、自动检查的流水线，让你的项目真正具备工程化能力。你会发现：当流水线自动跑起来，你的项目就真正活了。

“自动化测试不是为了机器，而是为了你能睡得更安稳。”

第21篇我们把第20篇的测试体系升级成生产级 CI/CD 流水线：每次代码提交或定时执行，自动跑 pytest + coverage，失败立即邮件通知，成功生成 HTML 报告。
本篇全部基于Python 3.8.10 + Win7 旗舰版实测通过，完美适配我们前20篇积累的D:\AutoOffice*知识库项目。
先讲底层原理*，再讲Win7 实战坑点，最后给出GitHub Actions 自托管 Runner + Jenkins 双方案和完整可直接复制的配置，让你的自动化脚本真正“无人值守 + 自动验证”。

1. 底层原理（源码、协议、机制）

CI/CD 核心：Continuous Integration / Continuous Delivery，通过Webhook + Runner机制实现。

• GitHub Actions：基于 YAML 声明式工作流（.github/workflows/*.yml）。
  底层原理：GitHub 收到 push/PR 时触发 webhook → 调度 Runner（虚拟机或自托管） → 执行 steps（shell/Python）。
  源码本质是 GitHub 的 Orchestrator + Docker-like 容器隔离，Runner 用actions/runner（.NET 编写）监听事件。

• Jenkins：经典 Java 自托管 CI 服务器。
  底层使用Pipeline as Code（Jenkinsfile 或 declarative pipeline），通过 Groovy DSL 描述阶段（stage）。
  Agent（Win7 机器）通过 JNLP 协议连接 Master，执行 Python 命令。

• pytest + coverage 集成：coverage.py 钩子coverage run -m pytest，生成 .coverage 文件 →coverage html输出报告。
  完全基于 Python 的trace模块和 pytest 的pytest-cov插件，无需额外协议。

（上图：Pytest 与 CI/CD 流水线经典集成流程）

2. Win7 特有实战坑点 & 库兼容性（提前避雷）

1. GitHub Actions 云 Runner 不支持 Win7：云端是 Windows Server 2022，无法精确复现 Win7 的 UTF-8 日志、路径限制等问题。必须使用自托管 Runner（在 Win7 本机运行）。
2. 自托管 Runner 权限：Win7 UAC 严格，Runner 必须以管理员身份运行，否则 pyautogui / 文件操作会失败。
3. Python 版本锁定：在 workflow 中必须指定python-version: 3.8（actions/setup-python@v4 支持 3.8）。
4. Jenkins on Win7：推荐 Jenkins 2.414（最后一个较稳定支持旧 Windows 的版本）。安装时需 JDK 8（Win7 兼容）。
5. 中文日志与路径：CI 环境中必须所有脚本强制encoding='utf-8'，否则 GitHub Runner（即使自托管）也会报编码错误。
6. 覆盖率报告：Win7 默认浏览器 IE，HTML 报告打开可能样式错乱，建议用 Chrome。