博客工具选型:为什么我最终从 Docusaurus 换回了 WordPress你有没有遇到过这样的情况:
一个标点符号的代价
在博客上发现文章里有个错别字,或者想调整一下某个段落的顺序。在 WordPress 后台,你点开编辑器,改完,点击“更新”——刷新页面,好了。前后不过几秒钟。
同样的事情换到 Docusaurus 这类静态站点生成器上呢?
你找到源文件,改了一个标点符号。然后:
- 在本地运行
npm run build - 等待构建完成(即使很快,也要十几秒到半分钟)
- 把生成好的静态文件上传到服务器
- 等上传完成,刷新页面
整个过程,快则一两分钟,慢则五六分钟。
问题不在“快慢”,在“心流”
有人会说:不就几分钟吗?等不起?
这不是耐心的问题。是写作心流的问题。
写博客不是写代码。写代码你本来就在“构建-运行-调试”的循环里,等几十秒编译是常态。但写文章不同——写文章是一种接近连续的创造过程。
当你写完一篇东西,发布出去,然后从头到尾读一遍,几乎总会发现:这里语气不对,那里举例不够贴切,甚至有个明显的病句。
在 WordPress 上,改这些是即时的。改完就看到了,像在水里调整一艘小船的航向,随时微调,随时修正。
在 Docusaurus 上,每一次修改都要等一轮构建。这个“等待”打断的不是你的时间,是你的注意力。等构建完成的那一两分钟里,你可能已经去刷朋友圈了,或者打开了另一个文档。再回来时,刚才那种“对文章的敏感度”已经丢了。
我的 WordPress 工作流:本地 Markdown + REST API
有人说 WordPress 自带的古腾堡编辑器不好用,我完全同意。
所以我给自己写了一套工具:在本地用熟悉的 Markdown 写文章,写完后通过 REST API 一键推送到 WordPress。
流程是这样的:
- 打开 VS Code,用 Markdown 写文章(所有本地习惯都用得上)
- 文章写完了,在终端敲一行命令
- 工具自动解析 Markdown,提取标题、标签、分类、正文(自动转成 HTML)
- 通过 WordPress REST API 直接发布
- 打开博客页面,文章已经在那里了
整个过程几秒钟。 不需要打开浏览器后台,不需要粘贴复制,不需要古腾堡编辑器。
改文章也是一样:本地改完 Markdown 文件,再敲一次命令,文章就更新了。
这个工作流既保留了 Markdown 的写作体验,又享受了 WordPress 即时发布的好处——两种优势兼得。
静态站点的优势,和个人博客不太相关
当然,Docusaurus 这类工具有它的好处:
- 性能极好(纯静态文件)
- SEO 友好
- 可以用 React 组件
- 版本控制友好
- 免费托管(GitHub Pages 等)
但这些对个人博客来说,真的是核心需求吗?
个人博客有多少流量,需要到“极致性能”这个级别?SEO 方面,WordPress 加上合适的插件也完全够用。至于用 React 组件写博客——说实话,大部分时候你就是在写 Markdown。
版本控制?个人改个标点符号,真的需要一个 Git commit 来记录吗?而且我本地 Markdown 文件本身就在 Git 里管理,文章的历史记录一点不少——既有了版本控制,又不用每次发布都走一遍构建流程。
工具应该服务于表达,而不是反过来
我见过很多人(包括曾经的我)陷入一种误区:在选博客工具的时候,把自己当成了一个“开发者”,而不是一个“写作者”。
你会认真比较构建速度、SSG 还是 SSR、静态资源 CDN 方案……但忘了问自己一个最简单的问题:什么工具能让我更愿意写,更愿意改?
对于个人博客,“随意发、随意看”是一种极其珍贵的能力。它让你把精力放在文字本身,而不是构建流程上。
WordPress + REST API + 本地 Markdown 这套组合,给了我两样东西:
- 写作的舒适感(不用离开编辑器)
- 发布的即时性(不用等构建)
如果你也想这么做
WordPress REST API 是开箱即用的。你只需要:
- 在 WordPress 后台设置一个 Application Password(用于认证)
- 写一个简单的脚本,用
POST /wp-json/wp/v2/posts创建文章 - 用
POST /wp-json/wp/v2/posts/{id}更新文章
我是用 Python 写了一个命令行工具,处理 Markdown 解析、frontmatter 读取、API 调用这些事情。你也可以用 Node.js、Go、或者任何你熟悉的语言——逻辑很简单,几个小时就能搞定。
我的结论
如果你是一个技术博主,写的内容本身就是代码、是架构、是工程实践,那 Docusaurus、Hugo、Next.js 这些工具很合适——你的读者也是技术人员,你的内容和工具同频。
但如果你只是记录思考、分享经验、写写想法——一个普通人的普通博客——WordPress + 本地 Markdown + REST API 可能是更好的选择。
不是因为它更强大,而是因为它更自由:
- 自由地在本地写作
- 自由地随时修改
- 自由地看到一个标点符号的改变——立刻生效
最后说一句:工具选择没有对错。适合你的,就是对的。这篇文章只是分享我的真实感受,希望能帮你少走一些弯路。
