核心用法
wp-to-static 是一款专业的 WordPress 静态化迁移工具，通过 SSH 直连服务器，利用 wget --mirror 抓取渲染后的完整 HTML，再经多轮优化生成精简的静态站点。整个流程高度自动化：从环境校验、SSH 连接测试、定位 WordPress 安装目录，到远程镜像抓取、本地同步、资源提取、URL 修复、字体自托管、WordPress 冗余代码清理，最终生成 Cloudflare Pages 配置并完成一键部署。
显著优点
1. 极致压缩：通过解析 HTML/CSS 引用关系，仅保留实际使用的资源，典型场景可从 1.5GB+ 压缩至约 25MB。
2. 零攻击面：静态站点无 PHP、无数据库、无 WordPress 后台，彻底消除传统 WP 的安全隐患。
3. 零托管成本：Cloudflare Pages 免费额度充足，支持全球 CDN 加速。
4. 像素级还原：镜像抓取确保视觉一致性，CSS/JS/图片完整保留。
5. 自托管字体：自动下载 Google Fonts 并本地化，避免外部依赖和隐私追踪。
6. 智能清理：自动移除 generator meta、EditURI、WP-JSON、缓存注释等 WordPress 特征标识。
潜在缺点与局限性
- 动态功能丢失：表单提交、评论、搜索、会员系统等动态功能需额外配置（如 Cloudflare Workers）。
- 更新流程复杂：内容更新需重新执行完整流程，无法像传统 WP 一键发布。
- 大型站点耗时：全站镜像和 rsync 同步在 GB 级站点上可能耗时较长。
- 服务器依赖：仍需临时访问原 WP 服务器执行
wget，非纯本地方案。 - CSS 解析局限：复杂的相对路径计算可能在极少数自定义主题中出现偏差。
适合人群
- 内容型博客、企业官网、文档站点等以展示为主的 WordPress 用户
- 追求极致安全、厌倦 WP 漏洞修复的管理员
- 希望彻底降低托管成本的小团队或个人开发者
- 准备弃用 WordPress 但需保留历史内容的归档场景
常规风险
- 凭证泄露风险：SSH 私钥、Cloudflare Token 需严格保管，工具已内置禁止日志回显的安全规则。
- 部署覆盖风险：Cloudflare Pages 部署为覆盖式，误操作可能导致线上站点异常。
- 本地验证缺失风险：工具强制要求本地 HTTP 服务验证后再部署，但用户确认环节仍存在人为疏忽可能。
- 路径解析边缘案例：非常规主题结构可能导致资源路径计算错误，需人工复核。