FTP 传了图片，WordPress 媒体库却不显示？Media Sync 插件完美解决

在我们手动 WordPress 独立站迁移，或者需要一次性上传几百张产品高清大图的时候，很多站长都会发现 WordPress 自带的媒体库上传太慢了，经常卡死报错。

于是，我们通常会直接登录宝塔面板，或者用 FTP 工具，把几十上百兆的图片直接拖进 wp-content/uploads 文件夹里。速度是快了，但当你满心欢喜地回到 WordPress 后台，打开“媒体库”一看——竟然一张新图片都没有！

别慌，不是图片丢了，也不是你的宝塔面板出了 Bug。今天这篇文章会告诉你原因，并教你用一款免费神器 Media Sync 完美解决这个问题。

为什么 FTP 传的图片，媒体库里看不到？

原因其实很简单：WordPress 的媒体库像是一个“有编制的户口本”。

当你通过 WordPress 后台的上传按钮传图片时，系统会做两件事：

1. 把图片存到服务器的文件夹里。

2. 在 MySQL 数据库里给这张图片“上户口”（生成一条数据记录）。

但是，如果你绕过后台，直接用 FTP 或宝塔面板把文件塞进文件夹，这就属于“偷渡”。文件确实物理存在于你的硬盘上了，但数据库里没有它的记录，WordPress 自然就不认识它，媒体库里也就显示不出来。

要解决这个问题，我们需要把这些“黑户”图片同步到数据库里。那么 Media Sync 它就是专门干这活的。

Media Sync 插件使用教程

这款插件完全免费，操作极其简单，专治各种图片不同步的疑难杂症。

第一步：安装并启用插件

1. 登录 WordPress 后台，点击 [插件] -> [安装插件]。

2. 搜索框输入 Media Sync。

3. 找到作者是 erolsk8 的那款插件，点击安装并启用。

WordPress官方库下载地址：https://wordpress.org/plugins/media-sync/
插件官方地址：https://mediasyncplugin.com/
如果你还不会安装插件建议参考：WordPress插件安装教程

第二步：扫描未登记的图片

1. 插件启用后，点击左侧菜单的 [媒体] -> [Media Sync]。

2. 进入插件页面后，你会看到一个大大的 [Scan Files] (扫描文件) 按钮，直接点击它。

3. 插件会自动扫描你 uploads 文件夹里的所有文件，并把它和数据库进行比对。几秒钟后，下面就会列出所有“在服务器上，但没在媒体库里”的文件。

第三步：一键同步（避坑关键点！）

这是最重要的一步，千万别勾错了：

1. 在扫描出的文件列表中，勾选你需要同步的图片（或者直接勾选最上面的全选框）。

2. ⚠️ 避坑警告： 注意看顶部，有一个 “Dry Run (test without making database changes)” 的选项。这个选项默认是勾选的！你必须把它取消勾选（去掉对勾）！ 如果你带着这个对勾点同步，它只会“模拟测试”一遍，根本不会真正把图片写入数据库。

3. 取消勾选 Dry Run 后，点击蓝色的 [Import Selected] (导入选中项) 按钮。

等待进度条跑完，刷新页面，你再回到媒体库，那些图片就全部整整齐齐地出现了！

图多了，网站变慢了？

如果你发现图片多了后，前台网页打开速度变慢，建议给网站配置 CDN 节点。你可以了解一下本站再用的 WPHOS Edge™ 底层优化引擎。我们通过全球边缘节点分发，不仅能瞬间加速你的超大图片，还能彻底攻克外贸网站在海外打开缓慢的致命痛点。[➔ 免费提交域名，获取网站提速诊断方案]