我是怎么把个人博客从本地折腾到正式上线的
这段时间，我把自己的博客从“有个想法”一点点折腾到了“真的能上线访问、能同步更新、能继续写下去”的状态。
中间看起来像是在配环境、改主题、接 GitHub、连 Cloudflare，但真正花时间的，还是把整套流程慢慢理顺：本地怎么写、仓库怎么管、文章怎么发、服务怎么部署、后面怎么维护。只有这些环节都串起来，博客才不只是一个临时项目，而是一个能长期用下去的个人站点。
这篇文章就当作一次阶段性复盘，记录一下我这段时间到底做了什么、踩了哪些坑，又是怎么一步步把博客搭起来的。如果以后我再折腾主题、迁移服务，或者重新调整内容结构，回头看这篇，至少还能知道最初这条路是怎么走过来的。
一、为什么还是想搭一个博客
现在能发内容的平台很多，公众号、知乎、即刻、朋友圈，随手都能写。
但我还是想要一个属于自己的地方。
原因也不复杂：
- 内容能自己掌控
- 结构可以自己安排
- 不会被平台样式和推荐机制牵着走
- 技术、记录、想法都能放在一起
- 时间久了以后，它会更像自己的数字花园
所以这次搭博客，不只是为了“有个站”，更是为了把写东西这件事，慢慢沉淀下来。
二、这次博客的大致技术方案
这次用的是：
- Hexo：负责静态博客生成
- Butterfly：作为主题方案
- Git / GitHub：做版本管理和远端同步
- Cloudflare Pages：负责托管和部署
这样搭的好处很明显：
- 本地写 Markdown 就行
- 博客生成快
- 部署成本低
- 后期迁移也方便
- 整体比较适合个人长期维护
三、从本地开始把博客搭起来
搭建过程里，最基础的一步还是先把 Hexo 项目跑起来。
一般流程其实就是：
- 准备 Node.js 环境
- 安装 Hexo CLI
- 初始化博客目录
- 安装依赖
- 本地启动预览
当博客第一次在本地成功跑起来的时候，事情其实只完成了一半。
因为“本地能看”不等于“以后好维护”。
后面真正花时间的，反而是这些事：
- 目录结构确认
- 文章路径管理
- 主题配置调整
- 仓库同步方式
- 部署链路是否稳定
四、主题、样式和博客的第一层完成度
站点能访问之后，下一步就是让它看起来像自己的东西，而不是一个刚初始化出来的默认页面。
这一步通常会做几件事：
- 配站点标题、副标题、描述
- 选主题并做基础配置
- 调导航、页脚、社交链接
- 统一页面风格
- 确认文章页、归档页、标签页这些基础页面是否正常
我这次选的是 Butterfly，主要是因为：
- 成熟稳定
- 文档多
- 可配置项比较全
- 默认效果就已经不错
对个人博客来说，能先“稳定地好看”，比一上来就深度魔改更重要。
五、把 Git 流程理顺，比想象中更重要
博客真正进入“可长期使用”的状态，其实是在 Git 流程理顺之后。
因为只要写博客，就绕不开这些问题：
- 改了哪些文件
- 哪些内容该提交
- 哪些是临时文件，不该进仓库
- 远端有没有同步
- 本地和线上是不是一致
这次在整理过程中，也专门把仓库里一些不该提交的内容区分出来了，比如：
- 本地状态文件
- 临时截图
- 分析过程中的中间产物
- 依赖目录里的无关内容
这一步虽然看起来不起眼，但特别关键。
因为博客仓库一旦从一开始就乱，后面会越来越难维护。
六、把博客推到远端，并接到服务上
博客光在本地跑起来还不够，真正完成闭环，还得把它同步到远端仓库，再接到托管服务上。
这一步的目标很明确：
- 本地修改后可以提交
- GitHub 上能看到版本记录
- 服务端能自动或手动部署
- 线上博客能随提交逐步更新
这次在推送过程中，也碰到了一个很典型的问题：
- 本地 commit 没问题
- remote 也能配置
- 但 push 会卡在认证上
这类问题本质上不是博客本身的问题，而是 GitHub 认证链路的问题。
把这一步走通之后，博客才算真的进入“持续可更新”的阶段。
Cloudflare Pages 配置过程
除了 GitHub 同步之外，这次真正让博客“上线”的关键步骤，还是接入 Cloudflare Pages。
这一步里，最重要的是把仓库、构建命令和输出目录配对好。对 Hexo 来说，只要构建链路设置正确，后面每次更新文章、重新部署，整体都会顺很多。
当仓库连接完成之后，Cloudflare 会开始进入构建队列。这个阶段其实很有仪式感，因为它意味着博客已经不只是本地项目，而是真正进入了线上部署流程。
等构建成功之后，站点就能够正常访问。看到页面真正在线打开的时候，感觉也和本地预览完全不一样——它说明这个博客已经从“我电脑里的一个文件夹”，变成了一个可以对外访问的站点。
七、现在的状态
到目前为止，这个博客已经不再是一个临时试验项目了。
它至少具备了几个基本条件：
- 有独立博客目录
- 有文章目录结构
- 有现成文章可继续扩展
- 有 Git 仓库进行版本管理
- 有远端同步目标
- 已经具备继续写、继续发的基础
换句话说，现在最重要的事情，已经不是“怎么搭”，而是“开始持续写”。
八、这次折腾里我觉得最有价值的几点
如果回头总结，这次搭博客最有价值的，不只是把技术链路跑通，而是明确了几件事：
1. 先跑通，再优化
不要一开始就想着把主题、SEO、统计、评论、CDN、性能优化一次做完。
先让它能写、能发、能更新，后面再慢慢补。
2. Git 不是附属品，而是博客的一部分
如果没有清晰的提交习惯，博客很快就会变成一堆不知道该不该留的文件。
3. 个人博客最重要的是“持续性”
页面再漂亮，如果后面不写，也还是空站。
真正让博客有价值的，还是一篇篇内容慢慢积累起来。
九、接下来准备写什么
博客搭起来之后，后面更想写一些真正能留下来的东西，比如：
- 技术折腾记录
- 工具使用心得
- AI/自动化实践过程
- 个人学习路径整理
- 一些日常里的小结和反思
它不一定要很正式，也不一定每篇都很长。
但我希望以后回头看的时候，能知道自己这一路到底做了什么、想了什么、踩过什么坑。
结尾
搭博客这件事，表面看是配环境、改配置、提代码，实际上更像是在给自己搭一个长期输出的空间。
现在这个空间总算搭好了一个基础版本。
后面就别老想着继续折腾框架了，先认真写几篇东西，比什么都值。