📌 简介
WP2Typecho Plus 是一款深度优化、功能强大的WordPress数据迁移至Typecho的插件。它基于原版 wordpress-to-typecho v1.0.3 Beta 进行二次开发，解决了原版插件在现代博客迁移中的诸多痛点。
🔧 一、核心优化点
- 分批导入与进度条：采用分批导入机制，有效防止因数据量过大导致的PHP执行超时和白屏问题，并提供直观的进度条展示。
- UTF8MB4字符集支持：全面兼容Emoji表情及各类特殊字符，确保内容完整迁移。
- 智能路径替换：自动替换文章内容中的旧WordPress站点域名及图片路径（
wp-content/uploads），减少迁移后的手动修改工作。 - 评论过滤功能：提供选项，可选择性地过滤来自垃圾评论或回收站的评论，保持新站点评论区的清洁。
- 异常数据容错：对数据库中可能存在的异常时间戳、空白标题等数据进行了兜底处理，避免在导入过程中因SQL报错而中断。
- 全版本WordPress兼容：解除了原版插件仅支持WordPress 2.7的限制，现支持更广泛版本的WordPress数据库。
🚀 二、安装与使用步骤
- 下载插件：从提供的链接下载插件压缩包
- 下载地址：WP2Typecho Plus 插件
- 解压与上传：解压下载的压缩包，将名为
WP2TypechoPlus的文件夹上传至您的Typecho站点的插件目录
/usr/plugins/WP2TypechoPlus
- 启用插件：登录Typecho后台，在「控制台」下拉菜单中找到并进入「插件」管理页面，启用 WP2Typecho Plus 插件。
- 配置插件：点击插件右侧的「设置」链接，填写原WordPress站点的数据库连接信息（地址、端口、用户名、密码、数据库名、表前缀）、旧站点域名以及评论过滤规则，保存配置。
- 进入迁移面板：保存配置后，控制台下拉菜单会新增「从Wordpress导入数据」选项，点击进入。
- 执行导入：插件先统计待导入数据，核对无误后点击「开始迁移」，等待进度条走完即可。
- 后续操作：迁移完成后可直接禁用/删除插件，不会影响已导入数据与网站正常功能。
🖼️ 三、图片处理（关键步骤）
⚠️ 重要提醒：本插件仅替换文章内图片链接地址，不会自动复制图片文件本身。
手动必做操作
将原WordPress站点 wp-content/uploads 目录下全部年月分类子文件夹，完整复制到Typecho站点 usr/uploads 目录。
📋 四、迁移数据范围
✅ 可导入数据
- 文章 (Posts)
- 页面 (Pages)
- 评论 (Comments)
- 分类 (Categories)
- 标签 (Tags)
- 分类与标签关联关系
❌ 不导入数据
- WordPress主题、插件配置
- 用户密码（安全隔离）
- 图片实体文件（需手动复制，见上文）
- 完整自定义字段（Custom Fields）
📝 五、内容状态迁移规则
- WordPress「已发布」文章 → Typecho「公开」文章
- WordPress草稿、待审核、私密、回收站等非发布内容 → 统一转为Typecho「草稿」
⚠️ 六、重要警告
- 务必备份数据库：迁移前完整备份当前Typecho数据库；插件导入前会清空本站现有文章、页面、评论、分类、标签。
- 只读读取原库：插件仅读取WordPress数据库数据，不会修改、删除原站任何内容。
❓ 七、常见问题排查
- 迁移后图片不显示
检查是否完整将wp-content/uploads全部文件复制至Typechousr/uploads。 - 导入报错「时间溢出」
新版内置时间戳容错机制，重新执行导入流程即可。 - 导入进度卡住不动
浏览器按F12打开开发者工具，切换Network面板查看接口报错；核对数据库连接配置，或调高服务器PHP内存限制。 - 部分文章前台无法查看
后台查看文章状态，WordPress草稿/私密内容会统一存入草稿箱，需手动发布。
📜 八、更新日志
- V2.0.0：彻底重构原版
wordpress-to-typecho v1.0.3 Beta，更名WP2Typecho Plus。新增分批导入、进度展示、utf8mb4兼容、域名图片路径自动替换、评论筛选、异常数据容错；解除WP2.7版本限制，修复原版各类导入报错。