你好，世界：我的博客开张了
缘起折腾了一个下午，终于把这个博客搭起来了。 过程比想象中顺利，也比想象中坑多。趁热把踩过的坑记下来，免得以后忘了。 技术栈 环节 选型 说明 静态站点生成器 Hexo 7.0 基于 Node.js，Markdown 写作 主题 Butterfly 5.7 中文生态最活跃的 Hexo 主题 代码托管 Gitee 国内访问快 部署 待定 Gitee Pages 已下架，改用替代平台 一个重要的教训网上的教程有很强的时效性。我照着 2021 年的文章操作，卡在了”开启 Gitee Pages 服务”这一步——这个功能 2025 年 10 月已经下架了。 搜索结果里的答案往往互相矛盾，最靠谱的做法是直接查官方文档或官方 issue。 接下来要做的 本地跑通 Hexo 换上 Butterfly 主题 部署到线上 绑定自己的域名 慢慢来，先把内容写好。
Hexo 写作指南：Markdown 语法速查
新建文章1hexo new "文章标题" 文章会生成在 source/_posts/ 目录下。 前置参数（Front-matter）每篇文章开头的 --- 包裹区域叫 front-matter，用来声明元信息： 12345678910---title: 文章标题date: 2026-10-16 14:00:00tags: - 标签1 - 标签2categories: - 分类cover: /img/cover.png--- 常用语法标题# 到 ###### 对应一到六级标题。 强调粗体、斜体、删除线。 列表无序列表用 -，有序列表用 1.。 链接与图片12[链接文字](https://example.com) 代码块用三个反引号包裹，并在开头标注语言： 123function greet(name) { console.log(`Hello, ${name}!`);} 引用 这是一段引用文字。 表格 语法 效果 **文字** 粗体 *文字* 斜...
搭建实录：从零到上线踩过的坑
坑一：Git 代理导致 clone 失败现象 123git clone https://gitee.com/xxx/yyy.gitfatal: unable to access '...': Failed to connect to gitee.com:443over proxy 127.0.0.1 after 2036 ms 定位 代理残留在了 Git 全局配置里，但本地那个端口根本没服务在跑： 12345git config --global --get https.proxy# http://127.0.0.1:10808netstat -ano | grep 10808# 无输出 = 端口没有监听 解决 12git config --global --unset http.proxygit config --global --unset https.proxy 坑二：Gitee Pages 下架网上教程清一色教你”仓库 → 服务 → Gitee Pages → 启动”，但 2025 年 10 月 11 日这个功能已经下架（官方 issue #ID...