WordPress博客列表页图片不显示问题求助

• 排查摘要显示逻辑：大部分主题的列表页调用的是文章摘要（the_excerpt()），而非完整正文（the_content()）。如果图片是直接插入正文、未设置为特色图片，摘要会自动过滤HTML标签（包括图片标签）。解决方式：要么在文章编辑页手动添加包含图片的自定义摘要；要么修改主题列表模板（比如index.php或archive.php），把the_excerpt()替换为the_content('阅读更多')。
• 检查图片插入方式：如果是通过第三方插件插入的图片，可能插件仅在单篇页面加载渲染逻辑，列表页未触发。换用WordPress原生媒体库插入图片，或者查看插件设置里是否有“在列表页启用图片渲染”的选项。
• 查看摘要过滤函数：部分主题或自定义代码会给the_excerpt()添加过滤规则，强制剥离HTML标签。可以到主题的functions.php文件中查找strip_tags()、wp_trim_words()这类函数，修改规则允许保留<img>标签，示例代码如下：

  add_filter('the_excerpt', 'custom_excerpt_allow_images');
  function custom_excerpt_allow_images($excerpt) {
      return strip_tags($excerpt, '<img>');
  }
  

• 确认图片路径：检查图片的URL是否为绝对路径（如https://你的域名/wp-content/uploads/2024/05/xxx.jpg），而非相对路径。相对路径会因列表页与详情页的URL层级不同，导致图片加载失败。
• 禁用缓存优化插件：缓存、图片压缩类插件可能在列表页错误地屏蔽或压缩图片。临时禁用这类插件，刷新页面测试，再逐个调整插件设置排查问题。

内容的提问来源于stack exchange，提问作者Fuaad