如何快速且最优地将5万张（50k）图片上传至WordPress媒体库？

方案一：服务器直传+WP CLI批量注册（最快最稳定） #

这是处理大数量图片的首选方案，完全绕过后台上传的HTTP限制，效率拉满：

• 第一步：直接传输图片到服务器
  用FTP、SCP或者服务器面板的文件管理器，把5万张图片传到WordPress的wp-content/uploads/[年份]/[月份]目录（比如2024/09，和WP媒体库默认的文件夹结构保持一致），服务器内部传输速度远快于后台上传。
• 第二步：用WP CLI注册入库
  登录服务器终端，切换到WordPress根目录，执行以下命令批量导入：

  wp media import --url=https://你的站点域名 ./wp-content/uploads/2024/09/**/*.{jpg,jpeg,png,gif} --title-from-filename --skip-duplicates
  

  可选参数说明：
  • --title-from-filename：自动用文件名作为图片标题
  • --featured-image：把图片设为对应文章的特色图（如果需要关联文章）
  • --skip-duplicates：跳过已经存在的图片，避免重复入库
    这个命令会自动完成媒体库注册、缩略图生成、数据库记录更新，全程服务器端执行，速度碾压后台操作。

方案二：批量上传插件+分批次处理（适合非技术人员） #

如果不会用命令行，选靠谱的插件分批次上传：

• 安装Media Library Folders插件：支持拖拽批量上传，建议每次上传500-1000张，避免服务器超时。上传完成后，插件会自动把图片录入媒体库。
• 或者用WP All Import：它支持读取服务器上的图片文件夹，批量导入时还能批量设置alt文本、标题等元数据，比原生后台上传稳定得多，适合需要统一设置元数据的场景。

方案三：自定义PHP脚本（适合开发人员定制） #

如果需要更灵活的自定义逻辑（比如按规则设置分类、标签），可以写个简单的PHP脚本：

<?php
// 引入WP核心文件
require_once('wp-load.php');
// 取消超时限制
set_time_limit(0);
// 设置内存限制
ini_set('memory_limit', '256M');

// 图片所在目录（替换成你的实际路径）
$upload_base = wp_upload_dir()['basedir'];
$image_dir = $upload_base . '/2024/09';
// 匹配所有图片格式
$image_files = glob($image_dir . '/*.{jpg,jpeg,png,gif}', GLOB_BRACE);

foreach ($image_files as $file_path) {
    $file_name = basename($file_path);
    // 检查文件类型
    $file_type = wp_check_filetype($file_name);
    if (!$file_type['type']) continue;

    // 准备附件数据
    $attachment_data = [
        'post_mime_type' => $file_type['type'],
        'post_title'     => sanitize_title(pathinfo($file_name, PATHINFO_FILENAME)),
        'post_content'   => '',
        'post_status'    => 'inherit'
    ];

    // 插入到媒体库
    $attach_id = wp_insert_attachment($attachment_data, $file_path);
    // 生成缩略图和元数据
    require_once(ABSPATH . 'wp-admin/includes/image.php');
    $attach_meta = wp_generate_attachment_metadata($attach_id, $file_path);
    wp_update_attachment_metadata($attach_id, $attach_meta);
}

把脚本放在WordPress根目录，通过浏览器访问或者终端执行即可，建议分批次处理（比如每次处理1000张），避免内存溢出。

关键注意事项 #

• 操作前务必备份数据库和文件，防止意外丢失数据。
• 调整服务器参数：把PHP的upload_max_filesize、post_max_size设大（比如64M以上），memory_limit设到256M以上，同时延长Apache/Nginx的超时时间。
• 缩略图生成：如果图片数量大，WP自动生成缩略图会慢，可以先用WP CLI导入图片，再执行wp media regenerate批量生成缩略图，效率更高。
• 文件名规范：避免用中文、特殊字符，尽量用英文+数字的文件名，防止导入失败。

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