网页里一张图片该不该写 alt,常常不是卡在措辞上,而是卡在角色判断上:它是页面内容的一部分,是一个按钮或链接,还是只负责视觉分隔?判断清楚这一点,alt 的写法基本就定了。alt 不是给每张图配一句说明,而是在图片无法显示、或读者借助辅助技术浏览时,仍然能获得同等信息或完成同样操作。
先判断图片在页面里的角色
可以把页面中的图片大致分成三类。传递信息的图片,去掉之后读者会缺少关键信息;承担功能的图片,本身是链接或按钮的一部分,读者需要通过它知道点击后会发生什么;装饰性图片,只是分隔、点缀、营造氛围,或者重复了旁边已经写清楚的内容。
| 图片角色 | 先问自己 | alt 应回答什么 |
|---|---|---|
| 传递信息 | 去掉这张图,读者会漏掉什么? | 图中对理解页面有用的信息是什么 |
| 承担功能 | 图片是否是可点击控件的一部分,且没有可见文字? | 点击后去哪里、执行什么动作 |
| 装饰 | 图片是否只负责分隔、氛围或重复旁边文字? | 不需要回答,使用空 alt |
角色并不总是靠图片内容本身决定,而要看它在页面中的位置。同一张产品照片,放在商品详情里可能需要描述关键外观信息;放在一段已经完整说明产品特点的文字旁边,只是增加视觉节奏,就可能按装饰图处理。判断标准不是“这张图好不好看”,而是“去掉它以后,页面的意思或操作会不会缺失”。
传递信息的图片:写信息,不写“图片长什么样”
信息性图片的 alt 应该直接说读者需要知道的内容,而不是描述图片的媒介形式。例如一张错误日志截图,写成“错误日志截图”帮助有限;写成“错误日志显示请求在连接后端服务时超时”,读者才能知道关键信息。图片里如果有必须让读者看到的文字,也应把关键文字或它的含义放进 alt,但不必把每个界面标签都抄一遍。
alt 里通常不需要以“图片”“照片”“截图”开头,辅助技术已经会把图片角色告诉读者。也不要用“如图所示”这类依赖视觉位置的表达。更自然的写法是直接陈述信息,例如“折线图显示错误请求数逐月下降”,详细数据则放在图片附近的正文或表格里。信息性图片的 alt 是替代信息,不是图片说明的复制品。
功能性图片:写目的地或动作
当图片是链接或按钮里唯一可读的内容时,alt 要说明点击后的结果,而不是描述图标长什么样。返回首页的房子图标,alt 应写“返回首页”,不是“房子图标”;打印按钮的图标,alt 应写“打印当前页面”,不是“打印机图案”。
<a href="/"><img src="home.svg" alt="返回首页"></a>
如果图标旁边已经有可见文字,图标本身通常就不再承担命名功能,可以用空 alt 避免重复播报。例如按钮上已经写着“搜索”,放大镜图标只需要作为视觉辅助:
<button><img src="search.svg" alt="">搜索</button>
功能性图片的 alt 也不要只写“点击这里”。读者需要知道点击后会发生什么,写“查看订单详情”比写“点击查看”更清楚。图片放在链接里、按钮里还是独立展示,会改变它的角色;判断时先看它是否承担了操作入口。
装饰性图片:空 alt 是明确标记
纯装饰图片应使用空 alt,也就是 alt=""。这不是偷懒,而是在明确告诉浏览器和辅助技术:这张图不承载额外信息,可以跳过。不要写 alt="装饰图片"、alt="背景图" 或 alt="分隔线",这些文字没有提供读者需要的信息,反而会增加干扰。
<img src="divider.png" alt="">
装饰性图片包括纯视觉分隔线、页面顶部的氛围图、与旁边文字完全重复的配图等。一个常见例外是:图片虽然看起来只是图标,但它是链接或按钮里唯一的可读内容,这时它已经承担功能,不能再用空 alt 跳过。换句话说,装饰性判断的前提是图片不承载信息,也不承担操作命名。
三个常见误区:文件名、周边文字和过长描述
文件名不是替代文本。alt="IMG_2034.jpg"、alt="banner-final-2.png" 对读者没有意义,图片加载失败时也帮不上忙。文件名可以留在 src 里,但不应该成为 alt 的内容。
不要把旁边的文字原样搬进 alt。如果图片下方已经有一段图注,或者左侧正文已经完整说明了图片内容,alt 再重复一遍会让辅助技术读者连续听到相同信息。此时应判断图片是否还提供图注之外的信息:有,就补充关键差异;没有,就考虑空 alt 或更短的表达。
alt 也不是越长越好。复杂图表、信息密集的截图不适合把全部内容塞进 alt。更合适的做法是用一句短 alt 概括图片主题,再在图片附近用正文、表格或列表提供详细数据。alt 负责让读者知道“这里有什么、为什么重要”,不是承担整段分析的场所。
发布前的快速检查
- 每个
<img>是否都保留了alt属性? - 纯装饰图片是否使用
alt="",而不是写“装饰图”? - 图标链接或图标按钮的
alt是否说明了目的地或动作? - 图片旁边已有可见文字时,
alt是否避免了重复? alt中是否混入了文件名、图片格式或“图片展示”之类无信息量的词?- 复杂图片是否在附近提供了更完整的文字说明?
先问图片在页面里做什么,再决定 alt 写什么。这个顺序比套用固定句式可靠:信息性图片写清信息,功能性图片写清动作,装饰性图片明确留空。做到这三点,大多数 HTML 图片的替代文本就不会偏得太远。








