本文约 2,481 字，预计阅读 7 分钟。文中命令与配置均经过实测，可直接参考执行。
引言
在文章编辑页明明上传并设置了「特色图片」，保存后到前台一看，列表页和文章页却空空如也，缩略图位置要么是占位图、要么干脆没有；有的站点更奇怪：新文章不显示，老文章的图却还在。这类「特色图片 / 缩略图不显示」的问题，在换主题、装插件或迁移站点后特别常见。它通常不是图片本身丢了，而是主题没有开启特色图片支持、模板里没调用、缩略图尺寸没生成，或者权限与缓存挡了路。别急着一张张手动加图，按下面几个层面排查，多半能找到症结并一次性修好。需要说明的是，特色图片（Featured Image）和缩略图（Thumbnail）在 WordPress 里其实是同一套机制——后台叫”特色图片”，代码里叫 the_post_thumbnail()，只是叫法不同。
故障原因分析
- 主题未声明支持特色图片：主题的
functions.php里没有add_theme_support( 'post-thumbnails' )，WordPress 就不知道要为主题文章启用缩略图。 - 模板没有输出：主题模板里缺少
the_post_thumbnail()调用，或调用条件写错，图片设了也不显示。 - 缩略图尺寸未生成：上传图片后没有生成对应尺寸的缩略图文件，模板请求的尺寸不存在。
- 尺寸被主题/插件改变：换了主题后注册了新的图片尺寸，但老图没有重新裁剪，缺文件。
- 图片文件权限或路径不对：
wp-content/uploads/权限异常，或站点迁移后图片 URL 仍指向旧域名。 - 被缓存或懒加载插件拦截：缓存、CDN、懒加载插件导致缩略图不输出或输出的是占位符。
分步解决方案
方法一：在主题里开启特色图片支持
先确认主题是否声明支持。若是自定义或旧主题，在子主题的 functions.php（不要改父主题，避免被覆盖）中加入：
<?php
add_action( 'after_setup_theme', 'mysite_theme_setup' );
function mysite_theme_setup() {
add_theme_support( 'post-thumbnails' ); // 为主题文章启用特色图片
add_image_size( 'mysite-card', 600, 400, true ); // 自定义尺寸，按需裁剪
}若你希望页面（page）也支持缩略图，可加 add_theme_support( 'post-thumbnails', array( 'post', 'page' ) );。保存后打开文章编辑页，右侧应出现「特色图片」面板。
方法二：在模板里正确调用缩略图
在主题模板（如 index.php、single.php、archive.php 或子主题里的同名文件）中，用下面的函数输出：
<?php if ( has_post_thumbnail() ) {
the_post_thumbnail( 'mysite-card', array( 'class' => 'entry-thumb' ) );
} ?>要点：用 has_post_thumbnail() 先判断，避免没图时报错；尺寸名要与你注册的一致（也可用内置的 thumbnail、medium、large、full）。修改前先把父主题模板复制到子主题再改。
方法三：重建缩略图
如果前台提示缺图、或新尺寸没生成，用「重新生成缩略图」插件（如 Regenerate Thumbnails）批量重建：
- 安装并启用该插件；
- 工具 → 重新生成缩略图 → 选择「重新生成所有缩略图」；
- 完成后清缓存再看前台。
这一步能补齐换主题后缺失的新尺寸文件，是最省事的方式。若站点图片很多，重建可能耗时较长，建议放在访问低谷执行，或分批进行。
方法四：排查迁移与权限问题
- 迁移后图片 404：进数据库把旧域名批量替换成新域名（如用 WP-CLI
wp search-replace或插件），或检查wp-config.php里WP_HOME/WP_SITEURL是否正确； - 权限异常：确保
wp-content/uploads/及子目录可读，目录一般 755、文件 644； - 文件是否存在：用 FTP 进
wp-content/uploads/年份/月份/看图片和其-600x400缩略图是否真的在。
方法五：排除缓存与插件干扰
暂时停用懒加载、图片优化、缓存类插件，清 CDN 缓存后再测。若停用后就正常，说明是插件冲突，逐个启用以定位。
常见踩坑点
- 把
add_theme_support写进父主题：更新即失效，应写子主题并挂after_setup_theme钩子。 - 只加尺寸不重建：老图不会自动生成新尺寸，必须重新生成缩略图。
- 模板里硬编码图片 URL：迁移域名后会 404，应统一用
the_post_thumbnail()输出。 - 忘记先判断是否有图：直接调用会输出空标签，影响版式。
- 改了尺寸后不刷新缓存：浏览器和 CDN 仍给旧图，误判”没生效”。
- 权限设错：上传目录被设成 700/600 会让前台取不到图，保持可读。
总结
主题不显示特色图片或缩略图，排查主线是「主题支不支持 → 模板有没有调用 → 尺寸有没有生成 → 路径权限对不对 → 缓存插件有没有干扰」。多数情况只要在子主题 functions.php 里补上 add_theme_support( 'post-thumbnails' )、在模板里用 the_post_thumbnail() 输出，再用「重新生成缩略图」补全尺寸，问题就解决了。养成修改走子主题、迁移后替换域名、定期清缓存的习惯，WordPress特色图片不显示这类问题就会大大减少，站点图文展示也能始终保持整齐美观。日后更换主题时，也建议先在测试环境验证缩略图是否正常显示，再上线到正式站点，以免又踩同样的坑。
