WordPress 换主题后,先挑一张发糊的旧特色图。找出新版卡片需要的尺寸,再查附件里有没有对应文件。缺文件时先为这一张生成,已有文件但前台继续用旧图时查模板取图。电脑和手机下载的是同一张图,却只有手机裁掉主体,则调整手机端的裁切设置。
先查新版卡片需要的尺寸
| 对照后看到什么 | 该动哪里 |
|---|---|
| 旧附件没有新版需要的尺寸 | 为这一张图生成目标尺寸。 |
| 新图已能打开,前台仍取旧文件 | 查卡片的取图设置。 |
| 手机和桌面取得同一文件,只有手机裁掉主体 | 检查手机端的图片容器与裁切方式。 |
从改版后已经看得到问题的地方开始。把首页地址、出问题的卡片和对应文章记下来。同一篇文章可能同时出现在首页、分类和文章详情。首页有问题而详情正常时,两处很可能调用了不同尺寸,或者同一张图放进了比例不同的画框。保留两处画面,后面能用正常页面判断修复有没有波及旧用法。
打开那篇文章的编辑页,点「特色图」,在媒体库找到当前选中的图片。核对上传日期、文件名和尺寸,把附件详情也留给维护者。旧文章重新传过特色图,图片就可能比文章新。两篇文章也可能共用一个附件,删除并重传要重新核对它们各自的选择。附件和文件的关系可沿媒体库的整理与引用检查复查。
在新版首页同一排再挑一张近期上传、显示正常的图。在使用区块模板的站点,打开「外观 → 编辑器」里的实际首页模板,点列表中的「文章特色图」区块,查看图片尺寸选项。用主题组件搭建的页面,去负责这张卡片的组件里找。后台只显示宽度和比例时,让维护者把主题登记的尺寸名及宽高与前台文件对上。
如果新图和旧图都被裁成同样的窄条,直接去看画框。只有旧图出问题、目标规格又不同,才需要查旧附件保存了哪些尺寸。
新规格没有文件时,为一张旧图补尺寸
WordPress 上传图片时会尝试生成站点当时所需的若干尺寸。换主题可能新增其他规格。主题可以注册新的宽度、高度和裁切方式。附件尺寸清单里记录的是这一张图已经生成的文件,两处记录应分开看。新模板的宽卡片要用某个尺寸,媒体库里又能看到原图,仍然有可能少那个衍生文件。 WordPress 官方课程
我在本地 WordPress 7.0 用同一张楼梯照片测了三次。原图是 1249 × 1650 像素。最初登记了一个 300 × 300 的硬裁切方图。随后加上新版宽卡片所需的 640 × 360 规格,此时附件里还没有那张宽图。测试页面请求这个新规格,WordPress 便回退到原文件。这个样本保留了改版前后都能打开的图,区别是新卡片尚无专用文件。
同一个附件最初只有旧方图。新尺寸尚未生成时,请求宽图的测试卡片回退到了 1249 × 1650 的原文件。

只为这个附件补尺寸后,测试请求得到了 640 × 360 的宽缩略图。原来的方图仍能打开。浏览器里最明显的变化是所选文件名有了新尺寸,画面能直接以宽比例放进卡片。假如你手里的原图只有 320 像素宽,先找清楚的原稿或缩小显示区域。给一张小图重新登记目标规格,不会找回原本没有的细节。原图足够但生成失败时,再按WordPress 图片后处理的检查步骤查写入和图像处理。附件链接带 -scaled 时,打开原图并查前台实际加载的文件,分别记下两张图的尺寸。
生成后核对 640 × 360 的新文件能打开,也再确认 300 × 300 的旧方图仍能打开。

横图已经存在时,检查页面为什么还在用方图
先单独打开新宽图,确认尺寸和主体正常。回到出问题的首页,在图片上点右键选「检查」,在 Chrome 开发者工具的 Elements 面板选中图片的 img 元素。切到 Console,输入 $0.currentSrc,它显示浏览器选中的完整地址。再到 Network 按文件名找实际请求,核它有没有成功返回。页面用了 srcset 时,浏览器选中的地址可能与源码的 src 不同。
假设新宽图在媒体库有记录,直接打开也正常,但首页卡片在电脑上仍取到 300 × 300 的旧方图,并把它拉到 460 像素宽。重生成已经解决了文件缺失,余下的问题是选图。到负责新卡片的模板、循环组件或区块里看它选择的图片规格。若输出的候选清单仍只有旧尺寸,修模板输出。若桌面取得宽图、窄屏却挑到另外一张比例出错的图,查响应式图片的选择和后备地址。
修完一处后,在无痕窗口重新打开那张首页,电脑和手机都做一次。新请求还是没出现时,检查用于浏览的公开页面是否已经更新、页面缓存是否仍返回旧 HTML,以及图片代理是否改写了地址。未登录页面的 HTML 仍指向旧图时,查页面缓存。HTML 已有新地址、请求却被改写时,再看图片代理。单纯在媒体库点击清理缓存,无法证明新版首页的 HTML 已更新。
手机才裁掉主体时,比较两种屏宽的图片容器
如果开发工具显示的地址完全一样,实际图像也是 640 × 360,却只在手机卡片丢了主体,就比较两种屏宽的图片框。CSS 的 object-fit: cover 会把图放大到铺满画框,比例不同的部分可能被裁去。它不改浏览器下载的文件。图片本来已经在生成时硬裁掉了主体,则在直接打开文件时也会看见缺失。这两种裁切需要分开判断。
我把同一张 640 × 360 宽图放进两个画框。一个显示完整画面,另一个使用更窄的框并启用铺满。浏览器取到的文件、像素尺寸完全一致,窄框里却只见中央区域。你的图如果是楼梯、长机身设备或人物合照,可以找一个清楚的参照物,比如最外侧扶手、机身铭牌或边上的人,检查切断发生在打开原文件时还是进入画框后。
同一张宽图,左右两边使用的是同一个请求,窄框铺满后只留下中央区域。

首页图可以裁掉边缘时,改对象位置,把需要识别的主体留在小屏范围内。照片里的整机外形、证书文字或型号必须全部露出时,可放宽比例、显示完整图,或独立做适合手机的构图。若现有宽衍生图打开后就缺主体,先核原图内容,再决定改注册裁切还是换新图。改完后切回电脑宽屏,看看主体有没有被另一处裁掉。
用新版首页和旧页面一起验收
要补缩略图时,先用 wp media image-size 查看当前站点登记的尺寸。下面只为附件 37 生成 lab_home_feature,--skip-delete 会保留旧缩略图,方便回访仍在用旧尺寸的页面。 WP-CLI 媒体重生成选项
wp media regenerate 37 --image_size=lab_home_feature --skip-delete
37 和尺寸名是本地试验的值。执行前,替换成当前站点中需要补图的附件 ID 和目标尺寸。
新主题如果沿用同一个名字却更改宽高,核附件文件的真实像素。尺寸名已经存在时,不能把它当成新文件生成成功。重建对应规格后,打开新图片核宽高,再回新版卡片看真实请求。用后台工具时也先确认它能限定到那张附件,并能保留旧文件。
检查结果要回到两张页面。新版首页应在电脑和手机取得合适图片,主体也应完整到能识别。改版前已存在的分类或详情如果仍读旧方图,继续确认它正常。把附件编号、新旧文件名、出问题的页面和两个屏宽记下来。若后面的几张图也缺同一规格,按受影响栏目分批,再用每组里最早上传的一张图复验。
同一栏目有的卡片取方图、有的取宽图时,给维护者各留一条页面地址和实际请求。若横图文件已存在,先修卡片读取,再复测两个屏宽。只有缺文件的旧附件才加入重生成清单。




