换模板后先别急着看整体观感,而要建立一份“内容清单—页面位置—渲染结果”的对照表:把原站每个页面的标题、正文块、图片、表格、表单和下载项列出来,再逐页检查新模板是否完整呈现。溢出的典型信号是横向滚动条、文字被裁切、卡片高度不一致;缺项的典型信号是某类区块整段消失、字段为空、列表只显示前几条。只有把这两类问题分开记录,才能判断是模板样式问题还是数据调用问题。
如果原站内容结构简单、页面类型少,优先用人工逐页核对。选这种做法的条件是:页面总量可控,且模板改动主要集中在样式层,没有更换字段结构。实施动作是打开浏览器开发者工具,逐个检查容器宽度、overflow属性和文本节点是否被截断,同时对照旧版页面截图确认区块数量。这样做的结果会直接决定下一步:若只是样式溢出,改CSS即可;若发现数据没被调用,就要回到模板的数据绑定层排查。
如果原站页面类型多、列表和详情共用模板,优先用脚本抽取内容再比对。选这种做法的条件是:你能拿到旧站和新站的页面清单,且页面之间有稳定的字段命名。实施动作是用爬取或导出方式生成两份内容清单,按页面路径对齐,比较每页的标题、段落数、图片数和链接数。结果会暴露两类差异:数量一致但显示异常,多半是样式问题;数量本身不一致,多半是模板条件判断或数据源过滤出了问题。
判断溢出时,不要只看页面截图。可核对的证据包括:容器是否出现横向滚动、文本是否被text-overflow截断、图片是否超出父级宽度、长单词或长链接是否撑破布局。把这些现象记在具体页面和具体元素上,才能避免把“看起来挤”误判为“内容溢出”。
判断缺项时,证据要落在内容来源上。可核对的证据包括:模板中是否还存在对应区块、数据源是否返回了该字段、条件判断是否把某类内容排除、分页或筛选是否改变了结果集。一个页面缺少某个区块,可能只是该页本来没有这类内容,也可能是模板条件写错,必须回到数据层确认。
这里有一个假设例子:假设某列表页原来显示二十条记录,换模板后只显示十条。这个现象不能单独证明模板把内容截断了,因为也可能是分页参数改变、数据源查询条件变化,或者模板只渲染了前十条。下一步应分别核对查询返回数量、模板循环范围和分页配置,再决定是改模板还是改数据逻辑。
先做一次全站内容盘点,产出三列清单:页面路径、应出现的内容块、实际渲染结果。这个动作的结果会形成问题分类:样式类问题进入CSS调整,数据类问题进入模板或接口排查,内容本身缺失则回到编辑流程补录。
接着对高风险页面做重点复核,包括长标题页、多图页、含表格页和表单页。长标题最容易触发溢出,多图页最容易暴露图片尺寸失控,表格和表单最容易出现字段被隐藏。复核结果若显示某类页面集中出问题,说明模板对该类内容的适配不足,应优先调整该类模板,而不是逐页打补丁。
最后建立回归检查点。每次修改模板后,用同一份内容清单重新比对,确认溢出和缺项没有新增。这个动作的结果会影响后续发布节奏:若回归检查稳定通过,可以继续扩大模板应用范围;若反复出现同类问题,应先收敛模板改动范围,再处理内容适配。
有些页面内容由第三方嵌入或动态加载,静态比对可能看不到完整结果,这类页面需要单独标记,不能仅凭初始HTML判断缺项。还有些内容在旧模板中本就未完整展示,换模板后不应把历史遗留问题算作新模板缺陷。明确这些例外,才能让识别结果真正指向需要修改的位置。