老网站改版时，图片本身往往有人管——谁负责重新导出、谁负责压缩、谁负责上传，都有分工。但图片说明（alt文本、图注、图片下方的说明文字）经常没人认领：新模板可能没有图注字段，批量迁移工具可能只搬图片文件不搬说明，编辑又会觉得“图能显示就行”。结果就是改版完成后，一批老页面里的图片说明要么全部丢失，要么原样复制了已经过时的描述。
图片说明处理的核心不是“写不写alt”，而是先弄清楚旧站里这些说明承担了什么作用，再决定哪些必须保留、哪些该重写、哪些可以随图片一起删掉。
先把旧站的图片说明盘出来
改版前建议做一次图片说明盘点，而不是等新站上线后再逐页补。盘点可以按下面的顺序推进：
- 导出旧站所有页面的图片清单，至少包含页面URL、图片文件名、图片所在位置（正文、Banner、产品图集、图标）。
- 对每张图记录它当前的说明内容：alt文本、图注、图片下方说明段落，分别记在单独一列，不要合并。
- 标记这张图属于哪一类：承载信息的图（流程图、参数表截图、产品细节图）、辅助理解的图（场景图、示意图）、纯装饰图（分隔线、背景纹理、通用图标）。
这一步的价值在于把“图片说明”拆成几种不同的东西。alt是给看不到图片的人用的替代描述，图注是给所有读者看的补充信息，两者写法不同，改版时的处理方式也不同。混在一起盘点，后面就容易一刀切。
按图片用途决定保留、重写还是删除
盘点完成后，逐类处理比逐页处理效率更高。判断标准可以这样定：
- 承载信息的图：说明必须保留，而且要重写。旧站里的描述可能写于几年前，产品型号、流程步骤、页面结构都可能变了，直接复制会把过时信息带进新站。重写时以图片当前展示的内容为准，写清楚图里有什么、读者能从图里得到什么。
- 辅助理解的图：说明可以保留但需要精简。这类图的说明往往写得过长，改版时压缩到一句话，说明这张图在讲哪个环节即可。
- 纯装饰图：说明可以简化或留空。装饰图不需要承载信息，硬写一段描述反而增加维护负担。但要注意，如果新模板把装饰图也当作内容图处理，需要和模板配置一起确认。
- 已经失效的图：图片本身不再使用，对应的说明一并删除，不要留在新站里变成没有对应图片的孤立文字。
这里有一个常见误区：改版时为了“不丢内容”，把所有旧说明原样搬过去。结果是新站里堆着一批描述过时、格式不一、甚至和当前页面主题无关的图片说明。图片说明不是越多越好，和图片对得上、和页面主题相关才有意义。
图片文件名和说明一起整理
图片说明处理时，文件名容易被忽略。旧站里常见的情况是图片叫 IMG_2031.jpg、tu1.png、未标题-2.jpg，改版后如果继续沿用，团队里没人能靠文件名判断这张图是什么，后续替换或复查都要重新打开看。
建议在改版阶段顺便把文件名规范化，规则可以按团队习惯定，但要满足两个条件：能看出图片内容，能看出所属页面或栏目。例如产品详情页的细节图，文件名里带上产品名和视图类型；栏目页的配图，文件名里带上栏目名。文件名不需要和alt文本完全一致，但两者应该指向同一张图，避免出现文件名说A、说明写B的情况。
如果旧站图片数量很大，可以只对改版中实际保留并重新上传的图片做规范化，已经确定删除的图片不必再改文件名。
改版上线前的图片说明复核
新站上线前，图片说明需要单独走一遍检查，不能只靠“页面能打开”来判断。建议按下面的顺序核对：
- 打开每个保留页面的正文，确认图片和它的说明在视觉上是对应的，没有出现说明写的是旧图、页面显示的是新图。
- 检查承载信息的图片，确认说明里提到的步骤、参数、名称和当前业务一致。
- 检查图注和alt是否重复。如果同一张图既有图注又有alt，且内容几乎一样，读者和辅助工具都会收到重复信息，可以合并或让两者各有侧重。
- 检查是否残留了指向旧图片路径的说明文字，尤其是从旧站复制过来的段落里可能还带着旧文件名或旧链接。
- 确认已经删除的图片，对应的说明也一并清理，不留孤立文字。
复核时不要只看首页和几个重点页面。老网站改版最容易出问题的是那些平时没人访问、但仍在对外展示的页面，比如几年前的新闻稿、旧版产品页、活动存档页。这些页面里的图片说明如果处理不当，读者看到的就是图文不符的内容。
什么时候可以暂时不动
不是所有图片说明都必须在改版当期处理完。如果旧站页面数量很大，可以按优先级分批：
- 优先处理仍在导航、首页、栏目页和主要转化路径上的页面。
- 优先处理承载信息的图片，装饰图的说明可以放到后面统一清理。
- 已经确定要下线的旧页面，不必再花时间重写图片说明，直接按下线流程处理。
分批处理的前提是盘点清单已经建立，否则“以后再说”很容易变成“一直没做”。清单里标注每张图的处理状态，改版上线后还能继续按这份清单推进剩余部分。
如果现在正处在改版准备阶段，可以先从导出旧站图片清单开始，把每张图的说明和用途记下来，再决定迁移时怎么处理。这一步做在前面，比上线后逐页找问题省事得多。
