跨境YOUNG

WordPress 换主题后旧图变糊或裁错,哪些缩略图需要重新生成

WordPress 换主题后旧图发糊或被裁切,先对照主题要的尺寸、附件已有的文件和浏览器实际下载的图片,再决定是否重新生成。
WordPress 媒体后台中的旧文章特色图测试附件
WordPress 媒体后台中的旧文章特色图测试附件

本页阅读目录

WordPress 换主题后,先挑一张发糊的旧特色图。找出新版卡片需要的尺寸,再查附件里有没有对应文件。缺文件时先为这一张生成,已有文件但前台继续用旧图时查模板取图。电脑和手机下载的是同一张图,却只有手机裁掉主体,则调整手机端的裁切设置。

先查新版卡片需要的尺寸

对照后看到什么该动哪里
旧附件没有新版需要的尺寸为这一张图生成目标尺寸。
新图已能打开,前台仍取旧文件查卡片的取图设置。
手机和桌面取得同一文件,只有手机裁掉主体检查手机端的图片容器与裁切方式。

从改版后已经看得到问题的地方开始。把首页地址、出问题的卡片和对应文章记下来。同一篇文章可能同时出现在首页、分类和文章详情。首页有问题而详情正常时,两处很可能调用了不同尺寸,或者同一张图放进了比例不同的画框。保留两处画面,后面能用正常页面判断修复有没有波及旧用法。

打开那篇文章的编辑页,点「特色图」,在媒体库找到当前选中的图片。核对上传日期、文件名和尺寸,把附件详情也留给维护者。旧文章重新传过特色图,图片就可能比文章新。两篇文章也可能共用一个附件,删除并重传要重新核对它们各自的选择。附件和文件的关系可沿媒体库的整理与引用检查复查。

在新版首页同一排再挑一张近期上传、显示正常的图。在使用区块模板的站点,打开「外观 → 编辑器」里的实际首页模板,点列表中的「文章特色图」区块,查看图片尺寸选项。用主题组件搭建的页面,去负责这张卡片的组件里找。后台只显示宽度和比例时,让维护者把主题登记的尺寸名及宽高与前台文件对上。

如果新图和旧图都被裁成同样的窄条,直接去看画框。只有旧图出问题、目标规格又不同,才需要查旧附件保存了哪些尺寸。

新规格没有文件时,为一张旧图补尺寸

WordPress 上传图片时会尝试生成站点当时所需的若干尺寸。换主题可能新增其他规格。主题可以注册新的宽度、高度和裁切方式。附件尺寸清单里记录的是这一张图已经生成的文件,两处记录应分开看。新模板的宽卡片要用某个尺寸,媒体库里又能看到原图,仍然有可能少那个衍生文件。 WordPress 官方课程

我在本地 WordPress 7.0 用同一张楼梯照片测了三次。原图是 1249 × 1650 像素。最初登记了一个 300 × 300 的硬裁切方图。随后加上新版宽卡片所需的 640 × 360 规格,此时附件里还没有那张宽图。测试页面请求这个新规格,WordPress 便回退到原文件。这个样本保留了改版前后都能打开的图,区别是新卡片尚无专用文件。

同一个附件最初只有旧方图。新尺寸尚未生成时,请求宽图的测试卡片回退到了 1249 × 1650 的原文件。

WordPress 旧附件的方形衍生图与宽卡片回退文件
本地 WordPress 真实生成结果。测试卡片并排展示原有方图和缺宽尺寸时实际取得的文件。

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

生成后核对 640 × 360 的新文件能打开,也再确认 300 × 300 的旧方图仍能打开。

同一个 WordPress 附件生成的新宽图和保留的旧方图
本地重生成后,宽尺寸和旧方尺寸可同时从同一个附件取得。

横图已经存在时,检查页面为什么还在用方图

先单独打开新宽图,确认尺寸和主体正常。回到出问题的首页,在图片上点右键选「检查」,在 Chrome 开发者工具的 Elements 面板选中图片的 img 元素。切到 Console,输入 $0.currentSrc,它显示浏览器选中的完整地址。再到 Network 按文件名找实际请求,核它有没有成功返回。页面用了 srcset 时,浏览器选中的地址可能与源码的 src 不同。

假设新宽图在媒体库有记录,直接打开也正常,但首页卡片在电脑上仍取到 300 × 300 的旧方图,并把它拉到 460 像素宽。重生成已经解决了文件缺失,余下的问题是选图。到负责新卡片的模板、循环组件或区块里看它选择的图片规格。若输出的候选清单仍只有旧尺寸,修模板输出。若桌面取得宽图、窄屏却挑到另外一张比例出错的图,查响应式图片的选择和后备地址。

修完一处后,在无痕窗口重新打开那张首页,电脑和手机都做一次。新请求还是没出现时,检查用于浏览的公开页面是否已经更新、页面缓存是否仍返回旧 HTML,以及图片代理是否改写了地址。未登录页面的 HTML 仍指向旧图时,查页面缓存。HTML 已有新地址、请求却被改写时,再看图片代理。单纯在媒体库点击清理缓存,无法证明新版首页的 HTML 已更新。

手机才裁掉主体时,比较两种屏宽的图片容器

如果开发工具显示的地址完全一样,实际图像也是 640 × 360,却只在手机卡片丢了主体,就比较两种屏宽的图片框。CSS 的 object-fit: cover 会把图放大到铺满画框,比例不同的部分可能被裁去。它不改浏览器下载的文件。图片本来已经在生成时硬裁掉了主体,则在直接打开文件时也会看见缺失。这两种裁切需要分开判断。

我把同一张 640 × 360 宽图放进两个画框。一个显示完整画面,另一个使用更窄的框并启用铺满。浏览器取到的文件、像素尺寸完全一致,窄框里却只见中央区域。你的图如果是楼梯、长机身设备或人物合照,可以找一个清楚的参照物,比如最外侧扶手、机身铭牌或边上的人,检查切断发生在打开原文件时还是进入画框后。

同一张宽图,左右两边使用的是同一个请求,窄框铺满后只留下中央区域。

同一张 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 和目标尺寸。

新主题如果沿用同一个名字却更改宽高,核附件文件的真实像素。尺寸名已经存在时,不能把它当成新文件生成成功。重建对应规格后,打开新图片核宽高,再回新版卡片看真实请求。用后台工具时也先确认它能限定到那张附件,并能保留旧文件。

检查结果要回到两张页面。新版首页应在电脑和手机取得合适图片,主体也应完整到能识别。改版前已存在的分类或详情如果仍读旧方图,继续确认它正常。把附件编号、新旧文件名、出问题的页面和两个屏宽记下来。若后面的几张图也缺同一规格,按受影响栏目分批,再用每组里最早上传的一张图复验。

同一栏目有的卡片取方图、有的取宽图时,给维护者各留一条页面地址和实际请求。若横图文件已存在,先修卡片读取,再复测两个屏宽。只有缺文件的旧附件才加入重生成清单。

我专注 Google SEO、独立站增长与 AI 工作流,实践覆盖 WordPress 外贸 B2B 询盘站和 Shopify DTC 品牌站。从关键词研究、网站架构到内容与技术优化,我关注每一步怎样影响流量、询盘和购买。

本站分享我的项目方法与复盘,说明为什么这样做、具体怎样执行,以及如何判断改动是否有效。

雨果跨境观察员 · 公众号、抖音、小红书同名账号:跨境YOUNG。

学习与查找

从入门开始,或回到问题目录:

关于跨境YOUNG

跨境YOUNG整理WordPress建站、Google SEO与AI SEO / GEO方法,并提供建站、代运营和顾问服务。

需要有人持续推进SEO?

网站已上线,但页面、内容、技术、内链和月度数据没有持续推进?可先诊断范围与优先级,再按月执行与复盘。

最具性价比的服务器

Hostinger 适合预算有限的新站和中小企业 WordPress 网站,托管、备份与基础性能配置比较完整。通过专属链接可享 20% 折扣,购买前再核对机房位置和续费价格。

专属链接含 20% 折扣;跨境YOUNG可能获得佣金,不会增加你的购买成本。