从 P1 到 P49：踩坑编年史

【踩坑实录】从 P1 到 P49：踩坑编年史

▍现象
办公套件工程的补丁编号排到了近百：从 P1 到 P90 加字母后缀的变体，五十余个补丁构成一份可审计的鸿蒙差异清单。这篇不讲某个具体的坑，讲这套编号背后的事故学——为什么有些工程修坑越修越顺，有些越修越乱。

▍编号制的价值
每个坑一个编号（P 加数字），编号背后四要素：现象（什么症状）、根因（为什么）、补丁（怎么修的）、证据（怎么验证的）。编年史的价值在纵向：按编号读下来，能看到问题的演化链（P47 关欢迎弹窗、P49 关自动保存杜绝崩溃恢复模态框——后者是前者引出的问题的预防性处置；P64 检测引擎退出、P65 僵尸态恢复阶梯——同一问题的两级深入）。没有编号的工程，这些问题就是一堆散落的记忆，谁也说不清第几个坑与第几个坑同源。

▍编年史的纪律
一，坑全登记（修了的、绕过的、放弃的，三种都有编号——放弃的坑登记为什么放弃，避免后人重挖）。二，补丁与编号双向索引（补丁文件头注引用坑编号，坑清单引用补丁位置——翻查两头能对上）。三，阶段复盘（每十个编号做一次归类：同类坑的共性是什么、哪些是环境差异的必然、哪些是流程可以预防的——补丁族里浮现的模式比单个坑值钱）。

▍真实编年史的形态
该工程的编号族谱举例：起点是构建系统的配置守卫（P1——环境差异从 configure 就开始），中段是桌面假设的逐项改道（对话框、字体、汉化、保存链），后段是运行时边界的治理（引擎退出的检测、僵尸态的恢复、重启通道的收敛）。族谱本身就是移植难点的地图——新工程对照这张地图能预判自己的坑带。

▍方法论沉淀
补丁编号制是低成本高回报的工程纪律：一个编号四行字的成本，换来可审计、可索引、可复盘的问题资产。Air 系列把它作为工程标配，各工程的坑位清单在适配全记录里都是这个格式。

五十余补丁的完整编年史在办公套件工程实录，apps 板块 56 篇欢迎对照阅读。