为何未添加图片说明时WordPress仍自动显示图片说明？

排查触发源 #

• 切换到默认主题（如Twenty Twenty-Four），验证是否为当前主题导致。若问题消失，需修改主题中图片说明的输出逻辑：找到调用图片说明的代码段，添加判断——仅当手动设置了图片说明时才输出内容。
• 禁用所有第三方插件，逐个重新启用，定位到引发问题的插件。可尝试关闭插件内自动添加图片说明的选项，或联系开发者获取更新。

代码禁用自动生成 #

如果是WordPress核心更新导致的自动生成行为，可在主题的functions.php（推荐使用子主题文件）中添加以下代码：

仅保留手动设置的图片说明 #

add_filter('wp_get_attachment_caption', function($caption, $post_id) {
    $manual_caption = get_post_field('post_excerpt', $post_id);
    return empty($manual_caption) ? '' : $caption;
}, 10, 2);

彻底移除图片说明输出 #

remove_filter('img_caption_shortcode', 'img_caption_shortcode', 10);
add_filter('img_caption_shortcode', function($empty, $attr, $content) {
    return $content;
}, 10, 3);

注意：修改代码前请备份文件，避免主题更新丢失自定义内容。

检查媒体设置 #

进入后台设置 > 媒体面板，查看是否存在自动添加图片标题/说明的选项，若有直接关闭即可。

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