把博客从零搭起来以后，我最想留住的是这些选择和坑

这篇更像一份给未来自己的建站备忘：博客怎么搭起来不重要，重要的是下次再迁、再改、再踩坑时，我别又从头想一遍。

当时折腾博客的时候，表面上是在选框架、挑主题、配部署；实际上每一步都在做取舍——什么足够用、什么只是看起来高级、什么东西现在省十分钟以后可能要补一个小时。

所以这篇我不准备写成教程，而是按自己的真实决策顺序留底：为什么选 Hexo、为什么最后用 Fluid、部署时到底哪里最容易犯低级错误。

为什么选 Hexo

之前用过 WordPress，太重了，光是维护数据库就烦。PHP 写的主题改起来也别扭，模板引擎跟现代前端的开发体验差太远。后来想过 Hugo，Go 语言写的确实快，但文档看着不太舒服，模板语法也绕。最后选了 Hexo，主要是生态好，主题多，Node.js 写的我也熟。遇到问题查 npm 包的源码比查 Go 的方便多了。

主题

试了几个——NexT、Butterfly、Fluid。最后选了 Fluid，主要是中文文档写得好，配置项也丰富，不用自己改太多代码就能用。NexT 经典但有点老气，Butterfly 功能花哨但有些多余。主题这东西，好不好看其次，关键是别折腾太久，不然时间全花在调样式上了。选一个差不多的，赶紧开始写内容才是正事。

部署

用了腾讯云的 EdgeOne Pages，原因是域名本来就挂在腾讯云，顺手。CI 走的 CNB，push 到 main 分支自动构建部署，还算省心。以前手动 FTP 上传的日子真是不想回去了。

中间踩了个坑：EdgeOne 的部署命令项目名写错了，白跑了两趟 CI。盯着 CI 日志看了半天，发现是自己 copy-paste 的时候少了个字母。调试 CI 的时候特别想骂人——不是骂系统，是骂自己。

后来学乖了，部署相关的配置全部截图或者记到笔记里，下次直接复制，不要再靠记忆力了。

速度

国内访问还行，毕竟 EdgeOne 有 CDN 加速。和 GitHub Pages 比，国内速度快不少——GitHub Pages 在国内有时候加载静态资源要好几秒，EdgeOne 基本秒开。但功能少一些，比如不支持 SSR 和 Edge Functions。不过纯静态博客够用了，本来也不需要那些高级功能。

以后有新的坑再补充。搞技术就是这样，没有”搞完了”这回事，只有”暂时不想动了”。