从 issue 到 patch：参与贡献

从 issue 到 patch：参与贡献——开源协作的完整链路，给想动手贡献的同学。

▍贡献的形态
问题报告（发现 bug 或文档错漏——高质量 issue 是贡献的起点：反馈模板的规范在社区同样适用）；代码贡献（修 bug 或加功能的 patch——从 issue 到代码的闭环：本篇的主线）；文档与翻译（文档改进与本地化——文档 patch 的门槛低价值高：新手贡献的最佳起点）；经验分享（踩坑与技巧的帖子——知识贡献：本论坛的知识帖就是这种形态）。

▍从 issue 开始的正确姿势
先搜再报（重复 issue 的合并成本——报告前搜一遍已有列表）；最小复现（问题的最简化——能十行代码说清的别用一百行：复现越简定位越快）；环境与版本（报告的环境三件套——版本对不上的报告没法处理）。

▍patch 的流程
认领（issue 的认领——避免重复劳动：声明我在做）；分支与修改（独立分支的修改——改动聚焦单议题：一个 patch 一件事）；自测（修改的验证——按工程要求的验证标准：测试与回归的门槛）；提交（patch 或拉取请求的提交——描述写清改了什么为什么：标题与正文的规范）；评审（维护者的评审往返——评审意见的响应与修改：礼貌与耐心的协作）；合并（贡献入库——变更记录里的名字：你的贡献成为项目的一部分）。

▍贡献的修养
读项目的贡献指南（每个项目的规矩不同——指南是第一入口）；改动最小化（顺手重构是大忌——patch 聚焦议题本身：风格跟随项目）；测试跟得上（改动的验证义务——带测试的 patch 优先合并）；沟通的耐心（评审的往返是质量过程——不是刁难是打磨）。

▍Air 系列的参与通道
论坛反馈（问题与建议的入口——反馈到修复的链路在共治篇）；工程实录的对照（56 篇实录的边界与坑位——对照你的场景提改进）；知识共建（论坛的经验帖——踩坑实录的 pit 系列欢迎投稿式分享）。

▍一句话
开源贡献的阶梯：好 issue、文档 patch、代码 patch——每一级都是贡献，从今天的第一步开始。

你的参与让生态更好，欢迎从发第一个帖开始。