Gutenberg图片区块控件中WordPress图片尺寸选项不显示

问题根源 #

你代码里的add_image_size('original', '', '', true)存在参数错误：WordPress要求图片尺寸的宽度必须是正整数，传入空字符串会导致该尺寸无法被系统识别，进而影响媒体库和编辑器的尺寸选项显示。

修正方案 #

1. 修复图片尺寸定义代码 #

将functions.php里的代码替换为以下内容：

add_action('after_setup_theme', 'my_theme_setup');

function my_theme_setup() {
     if ( function_exists( 'add_theme_support' ) ) {
         add_theme_support( 'post-thumbnails' );
         // 自定义原图尺寸：用9999表示不限制宽度，高度自适应
         add_image_size( 'original', 9999, '', true );
         // 自定义large尺寸：宽度700，高度自适应
         add_image_size( 'large', 700, '', true );
     }
}

add_filter( 'image_size_names_choose', 'my_custom_sizes' );
 
function my_custom_sizes( $sizes ) {
    return array_merge( $sizes, array(
        'original'  => 'Original',
        'large'     => 'Large'
    ));
}

说明：如果不需要自定义「Original」尺寸，可直接删除对应的add_image_size行和my_custom_sizes里的'original'项，WordPress默认提供的「Full Size」就是原图选项。

2. 重新生成缩略图 #

由于之前的错误尺寸定义，已上传的图片没有生成对应尺寸的文件，需要用Regenerate Thumbnails这类工具重新生成所有图片的缩略图，确保自定义尺寸的图片文件存在。

3. 验证效果 #

重新进入文章编辑页面，插入图片时媒体库会显示自定义的尺寸选项；在Gutenberg图片区块的右侧「区块」面板中，「尺寸」控制项也会正常显示。

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