智能工具库

自动检查通过的替代文本,真的合格吗?

自动检查通过的替代文本,真的合格吗?

GitHub 无障碍团队实习生指出,自动检查通过的替代文本(alt text)未必有效。文章通过实例分析,教你如何写出真正有帮助的 alt text,并强调人工判断的重要性。

2026-08-25 0来源:GitHub Blog

自动检查通过的替代文本,真的合格吗?

在开发网页时,为图片添加替代文本(alt text)是无障碍设计的基本要求。很多团队依赖自动化工具来检查 alt text 是否存在,但 GitHub 无障碍团队的两位前实习生 Taarik Ashenafi 和 Keenan Zhou 提醒我们:自动检查通过,不代表 alt text 就是合格的

为什么自动检查不够?

自动检查通常只验证 alt text 属性是否为空。这意味着,即使 alt text 是一串无意义的字符,或者与图片内容完全不符,也能通过检查。这就像考试只检查你是否交了卷,而不看答案是否正确。

一个真实的例子

假设一张图片展示的是 GitHub 的 logo。自动检查会认为 alt="GitHub" 是合格的,因为它非空。但如果你写的是 alt="图片",虽然非空,却完全没有传达任何信息。对于使用屏幕阅读器的用户来说,这毫无帮助。

更糟糕的是,有些开发者会用 alt="image"alt="photo" 这类通用词,这同样没有意义。自动检查无法分辨这些差异,但真实用户却能立刻感受到差别。

如何写出真正有用的 alt text?

要写出有效的 alt text,需要遵循以下原则:

  • 描述内容,而非形式:alt text 应该描述图片传达的信息,而不是图片本身。例如,一张显示“404 错误”的截图,alt text 应为“404 错误页面截图”,而不是“一张截图”。
  • 简洁但完整:尽量用一句话概括图片的核心信息,避免冗长。如果图片包含复杂数据或图表,可以考虑在正文中提供详细描述,而不是塞进 alt text。
  • 考虑上下文:同样的图片,在不同场景下可能需要不同的 alt text。例如,一张产品照片在购物网站上应描述产品外观,在品牌故事中则可能强调情感或背景。
  • 装饰性图片用空 alt:如果图片纯粹是装饰性的,应使用 alt="",让屏幕阅读器跳过它,而不是添加无意义的文字。

对开发者的实用建议

  1. 不要只依赖工具:将 alt text 的审查纳入代码评审流程,让团队成员人工检查。
  2. 使用无障碍测试工具辅助:像 axe 或 Lighthouse 可以检测缺失的 alt,但它们无法评估质量,所以需要结合人工判断。
  3. 建立团队规范:在项目文档中明确 alt text 的编写标准,并给出示例,帮助新成员快速上手。
  4. 测试真实用户:如果条件允许,邀请使用屏幕阅读器的用户进行测试,他们的反馈是最直接的。

结语

Alt text 是连接视觉内容与无障碍用户的重要桥梁。自动检查只是最低门槛,真正的质量需要开发者用心打磨。下次提交代码时,不妨多花一分钟,审视一下你的 alt text 是否真的“有用”。

对于 AI 使用者来说,如果你在用 AI 生成网页代码,务必检查它生成的 alt text 是否合理,因为 AI 往往只会生成看似合规的占位符。记住,技术是辅助,人性化才是核心。

本文基于 GitHub Blog 的公开内容,由 AI 辅助整理改写后发布。

原标题:Your alt text passes automated checks. That doesn’t mean it’s any good.

阅读原文