无回归修复
修复问题并确认没有引入新的故障。
无回归修复 是 CoddyKit 上的免费 Web Accessibility Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Web Accessibility Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Web Accessibility Academy 课程共包含 4 节课。
修复一个问题可能引发另一个问题
粗心的无障碍修复可能悄悄破坏原本正常的功能。修复意味着解决问题，同时不引入新的回归问题。🔧
修复前先复现
首先按照报告中的描述准确复现错误。如果您无法按需使它失败，就无法证明修复确实有效。
优先使用原生 HTML
最安全的修复通常意味着更少的代码。将伪造的 div 换成真正的按钮，就能自动恢复焦点、按键操作和角色。
<!-- Replace this -->
<div onclick="save()">Save</div>
<!-- With this -->
<button onclick="save()">Save</button>改动最小范围
只改动问题所需的部分。范围明确的改动更容易审查，也不太可能波及其他功能。
使用相同工具重新测试
使用发现问题的同一款键盘和屏幕阅读器验证修复效果。重现原来的操作步骤，并确认障碍已经消除。
检查周边区域
不要只看修复的元素。新增的aria-label或移动焦点可能会改变附近控件的播报方式，因此请重新测试整个流程。
留意视觉回归
恢复焦点轮廓或对比度可能会改变布局。请确认在正常大小和缩放大小下，视觉设计仍然成立。
用测试锁定修复
添加自动检查，例如 axe-core 断言，这样如果以后有人重新引入同样的问题，构建就会失败。
const results = await new AxeBuilder({ page }).analyze();
expect(results.violations).toEqual([]);快速检查
有一个习惯最能防止修复引发回归。
绝不要为了通过检查而隐藏问题
不要使用 aria-hidden 或 display none 来让扫描器不再报错。这样只是把症状从工具中隐藏起来，真实用户仍然会遇到障碍。
记录改动内容
在拉取请求中记录修复内容，并链接到原始问题。清晰的变更日志能帮助审查者和未来的您理解这样修改的原因。
在真实环境中验证
请在预发布构建中确认修复效果，不要只在本地验证。真实环境测试可以尽早发现缓存、打包和配置方面的意外问题。
总结：安全修复
您需要重现问题，用最小的原生改动进行修复，重新测试流程，用测试加以防护，并在预发布环境中验证。这样就不会引入回归。🎉
用 AI 导师学习 HTML — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「无回归修复」课时是免费的吗？
是的 — 「无回归修复」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Web Accessibility Academy 课程的其余内容，请升级到 CoddyKit PRO。 Web Accessibility Academy 课程共包含 4 节课。
「无回归修复」这节课中我会学到什么？
修复问题并确认没有引入新的故障。 你通过在浏览器中直接运行的动手代码来练习 Web Accessibility Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Web Accessibility Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Web Accessibility Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「无回归修复」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Web Accessibility Academy 课中编写并运行代码吗？
能。每节 Web Accessibility Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。