mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4mobile wallpaper 5
1152 字
3 分钟
辞退WordPress,拥抱Astro:从wordpress迁移至Astro的记录
2026-02-21

写在前面#

最近我将自己的博客从 wordpress 迁移到 Astro ,对于我和我的博客来说都是一次很大的改变。这意味着我不再需要去考虑服务器相关的维护,可以专注于自己的文章

Astro 是一个静态站点生成器,没有数据库、没有后台,所有文章都以 Markdown 的形式存储,对于我来说,这其实放到比动态更具优势,因为我只是想要一个简单耐用,想写就写的站点,动态博客给我的实在是太多了,大部分功能其实我都用不上。而且Markdown的泛用性让我在未来需要修改或再次迁移博客时有着更好的灵活性

关于部署#

我使用了 Mizuki 作为静态博客模板,它基于 Astro 构建,我会把地址贴在下面,还有关于这个项目的文档

matsuzaka-yuki
/
Mizuki
Waiting for api.github.com...
00K
0K
0K
Waiting...

在wiki中能找到很详细的部署方法

因为我之前的站点就是 edgeone 配置的 cdn 和部分安全功能,而 edgeone Pages 可以实现静态网站托管服务,并且与 GitHub 集成良好,并且提供免费服务,但是目前好像会默认绑定到我的免费套餐上且无法切换到个人版,但免费版也完全够用了

首先按照文档中的内容在自己的新开的文件夹中克隆仓库并上传至 Github 仓库

git clone https://github.com/matsuzaka-yuki/mizuki.git //克隆仓库

在腾讯云的 Edgeone Pages 中绑定自己的 Github 账号,创建项目并选择自己刚刚上传的仓库

关于构建设置

  1. 框架预设:选择 “Astro”
  2. 构建命令:修改为 pnpm i && pnpm build
  3. 输出目录:设置为 dist
  4. Node.js 版本:建议选择 18.x 或更高版本

稍等片刻网站便能成功部署,你可以点击预览获取到临时链接;项目中,你还可以在域名管理中添加自己的自定义域名

现在可以切换到自己本地的仓库中按照文档更改 config.ts 等配置文件,配置完后直接推送到Github,Edgeone会自动使用最新的仓库来重新构建

关于迁移#

文章迁移#

wordpress的文章可以通过后台内置的工具导出,会得到一份.xml文件,还需要将.xml文件转换格式为.md

这里使用网上搜到的脚本来批量转换文章

缺点就是部分地方可能会有些无意义或者乱七八糟的格式,需要手动去校对文章,还要把原文中的图片迁移至新博客下存储并修改md文件中的链接为本地链接,补上文章的frontmatter

评论迁移#

我并没有找到什么非常好的方法来把两个博客的评论系统之间迁移,因此只能把之前评论的人们在wordpress中留下的信息手动copy到相应的文章和页面中

Mizuki使用的是 Twikoo 评论系统,我同样会贴上这个项目的文档

需要注意的是,这个项目的文档似乎有段时间没更新了,其中有关腾讯云部署的教程已经和现在平台上选项已经对不上且说明模糊不清,而且现在腾讯云的云函数功能是需要收费的,这就有点不符合我当初转移博客省点钱的理由了

但我在项目的pr中看到了其他开发者修改的Edgeone Pages版本

Mintimate
/
twikoo-eo
Waiting for api.github.com...
00K
0K
0K
Waiting...

具体部署流程在项目中也有说明,同样可以绑定自定义域名,将地址填写到博客相应配置文件中即可

如果可以可以去给项目作者一个start

音乐api#

就是你现在能看见的右下角的音乐播放器,在我调整博客的时候发现项目自带的演示用api失效了,于是便去找了其他人搭建的api,非常感谢

我会将那位博主的文章链接贴在这

总结#

断断续续花了我大过年2、3天时间将博客迁移完,这次迁移也是下定了决心来迁移的,毕竟从woredpress等动态博客迁移到静态容易,如果以后想要迁移回去可没这么简单,希望我以后能慢慢写下去吧

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

辞退WordPress,拥抱Astro:从wordpress迁移至Astro的记录
https://www.yisibuwang.top/posts/2026-02-20-辞退wordpress拥抱astro从wordpress迁移至astro的记录/
作者
buwang
发布于
2026-02-21
许可协议
CC BY 4.0

部分信息可能已经过时