WP2Typecho Plus 保姆级使用教程｜解决旧迁移插件超时、乱码、图片失效问题

📌 简介

WP2Typecho Plus 是一款深度优化、功能强大的WordPress数据迁移至Typecho的插件。它基于原版 wordpress-to-typecho v1.0.3 Beta 进行二次开发，解决了原版插件在现代博客迁移中的诸多痛点。

🔧 一、核心优化点

1. 分批导入与进度条：采用分批导入机制，有效防止因数据量过大导致的PHP执行超时和白屏问题，并提供直观的进度条展示。
2. UTF8MB4字符集支持：全面兼容Emoji表情及各类特殊字符，确保内容完整迁移。
3. 智能路径替换：自动替换文章内容中的旧WordPress站点域名及图片路径（wp-content/uploads），减少迁移后的手动修改工作。
4. 评论过滤功能：提供选项，可选择性地过滤来自垃圾评论或回收站的评论，保持新站点评论区的清洁。
5. 异常数据容错：对数据库中可能存在的异常时间戳、空白标题等数据进行了兜底处理，避免在导入过程中因SQL报错而中断。
6. 全版本WordPress兼容：解除了原版插件仅支持WordPress 2.7的限制，现支持更广泛版本的WordPress数据库。

🚀 二、安装与使用步骤

1. 下载插件：从提供的链接下载插件压缩包
2. 下载地址：WP2Typecho Plus 插件
3. 解压与上传：解压下载的压缩包，将名为 WP2TypechoPlus 的文件夹上传至您的Typecho站点的插件目录

/usr/plugins/WP2TypechoPlus
复制

1. 启用插件：登录Typecho后台，在「控制台」下拉菜单中找到并进入「插件」管理页面，启用 WP2Typecho Plus 插件。
2. 配置插件：点击插件右侧的「设置」链接，填写原WordPress站点的数据库连接信息（地址、端口、用户名、密码、数据库名、表前缀）、旧站点域名以及评论过滤规则，保存配置。
3. 进入迁移面板：保存配置后，控制台下拉菜单会新增「从Wordpress导入数据」选项，点击进入。
4. 执行导入：插件先统计待导入数据，核对无误后点击「开始迁移」，等待进度条走完即可。
5. 后续操作：迁移完成后可直接禁用/删除插件，不会影响已导入数据与网站正常功能。

🖼️ 三、图片处理（关键步骤）

⚠️ 重要提醒：本插件仅替换文章内图片链接地址，不会自动复制图片文件本身。

手动必做操作

将原WordPress站点 wp-content/uploads 目录下全部年月分类子文件夹，完整复制到Typecho站点 usr/uploads 目录。

📋 四、迁移数据范围

✅ 可导入数据

• 文章 (Posts)
• 页面 (Pages)
• 评论 (Comments)
• 分类 (Categories)
• 标签 (Tags)
• 分类与标签关联关系

❌ 不导入数据

• WordPress主题、插件配置
• 用户密码（安全隔离）
• 图片实体文件（需手动复制，见上文）
• 完整自定义字段（Custom Fields）

📝 五、内容状态迁移规则

• WordPress「已发布」文章 → Typecho「公开」文章
• WordPress草稿、待审核、私密、回收站等非发布内容 → 统一转为Typecho「草稿」

⚠️ 六、重要警告

1. 务必备份数据库：迁移前完整备份当前Typecho数据库；插件导入前会清空本站现有文章、页面、评论、分类、标签。
2. 只读读取原库：插件仅读取WordPress数据库数据，不会修改、删除原站任何内容。

❓ 七、常见问题排查

1. 迁移后图片不显示 检查是否完整将 wp-content/uploads 全部文件复制至Typecho usr/uploads。
2. 导入报错「时间溢出」 新版内置时间戳容错机制，重新执行导入流程即可。
3. 导入进度卡住不动 浏览器按F12打开开发者工具，切换Network面板查看接口报错；核对数据库连接配置，或调高服务器PHP内存限制。
4. 部分文章前台无法查看 后台查看文章状态，WordPress草稿/私密内容会统一存入草稿箱，需手动发布。

📜 八、更新日志

• V2.0.0：彻底重构原版 wordpress-to-typecho v1.0.3 Beta，更名WP2Typecho Plus。新增分批导入、进度展示、utf8mb4兼容、域名图片路径自动替换、评论筛选、异常数据容错；解除WP2.7版本限制，修复原版各类导入报错。