WordPress插件自定义图片尺寸注册失败，如何正确注册并调用？

• 自定义尺寸仅对新上传的图片生效：你注册的尺寸是在插件启用后添加的，之前上传的产品图片不会自动生成该尺寸的缩略图，所以wp_get_attachment_metadata返回的sizes数组里没有这个条目，WordPress只能返回原图的scaled版本。
• 原图尺寸不足：如果产品原图的宽或高小于500px，WordPress不会生成这个自定义尺寸的缩略图（软裁剪模式下不会拉伸图片）。
• 钩子执行优先级冲突（概率较低）：如果有其他插件/主题修改了init钩子的优先级，可能导致你的尺寸注册代码晚于图片元数据初始化，无法被识别。

一、规范自定义尺寸注册代码 #

保持代码可读性，明确参数含义，确保钩子正常执行：

function myplugintest_custom_image_sizes() {
    // 软裁剪模式：保留原图比例，取最大边适配500x500；若需强制裁剪成正方形，把最后一个参数改成true
    add_image_size( 'myplugintest-size-500-500', 500, 500, false );
}
// 用默认优先级10挂载init钩子，确保在系统初始化时执行
add_action( 'init', 'myplugintest_custom_image_sizes' );

二、为旧图片生成自定义尺寸缩略图 #

已上传的旧图片不会自动适配新注册的尺寸，需要手动触发生成：

1. 临时代码生成：在插件中添加以下代码，访问一次后台后删除（或添加标记避免重复执行）：

function myplugintest_regenerate_old_images() {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    // 跳过已执行标记，避免重复运行
    if ( get_option( 'myplugintest_regenerated' ) === 'done' ) {
        return;
    }

    // 获取所有图片附件
    $attachments = get_posts( array(
        'post_type'      => 'attachment',
        'post_mime_type' => 'image',
        'numberposts'    => -1,
        'post_status'    => 'inherit',
    ) );

    foreach ( $attachments as $attachment ) {
        wp_generate_attachment_metadata( $attachment->ID, get_attached_file( $attachment->ID ) );
    }

    // 标记执行完成
    update_option( 'myplugintest_regenerated', 'done' );
}
add_action( 'admin_init', 'myplugintest_regenerate_old_images' );

2. 插件工具生成：安装「Regenerate Thumbnails」插件，通过后台工具批量重新生成所有图片的缩略图。

三、验证与调整 #

• 上传新图片测试：在媒体库上传一张宽高均≥500px的图片，用wp_get_attachment_metadata($image_id)查看sizes数组，确认是否包含myplugintest-size-500-500。
• 调整裁剪模式：如果需要强制生成500x500的正方形图片，把add_image_size的第四个参数改为true，这样WordPress会裁剪原图到指定尺寸，不受原图比例限制。

四、排查干扰因素 #

• 检查图片优化插件：部分图片压缩插件（如Smush、ShortPixel）会禁用自定义尺寸或清理未使用的缩略图，需在插件设置中允许自定义尺寸生成。
• 确认尺寸名称唯一性：确保myplugintest-size-500-500这个名称没有和主题、其他插件的尺寸名称冲突，保持前缀唯一性可以避免这类问题。

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