拿到生成结果,别急着运行。按固定顺序先扫五处,能在几分钟内挡掉大部分「看着挺好、上线就出问题」的情况。
01第一项:内容在不在源码里
查看返回的主文档,确认标题、正文与链接是直接写在页面里的。若主体要等脚本执行完才拼出来,脚本失效、被辅助技术读取或只取文本时就会是空的。这一项最容易被忽略,也最容易在生成结果里出现。
关于「生成代码审查」,最常被漏掉的往往不是功能,而是键盘、标签关联与替代文本这些不显眼的细节。
02第二项:结构与可访问名称
检查是否用对了标题层级、地标与列表,图片有没有替代文本,表单字段有没有关联标签,图标按钮有没有可读名称。这些问题在截图上完全看不出来,却决定页面换一种方式还能不能用。
「生成代码审查」里的接口名、版本号与配置项,要去原始文档核对,读起来合理不代表真的存在。
03第三到五项:输入输出、窄屏与依赖
第三到五项是一次收尾:看外部输入是否通过参数绑定进入查询、结构部分是否来自白名单,再看所有进入页面的文本是否按上下文做了转义;生成结果常把示例里的简写当成最终写法,这两处要逐行确认,不能只看功能跑通。接着把窗口收到 375 像素检查是否出现横向滚动,并确认没有悄悄引入外部字体、脚本或样式——不必要的第三方依赖既拖慢首屏,也多一层不确定性。五项过完,再谈美化与细节。
把「生成代码审查」的约束写具体:目标环境、不能引入什么、必须保留什么,比多写几轮描述有效。
要点速览
- 先确认正文直接写在主文档里。
- 再查标题层级、地标、替代文本与字段标签。
- 输入用参数绑定,输出按上下文转义。
- 最后验 375 像素无横向滚动、无多余外部依赖。
五分钟的固定清单,能省掉上线后几小时的补救。
