“博客从0搭建到使用过程”

博客搭建：

使用 Hexo（框架）、Butterfly 主题（由安知鱼维护）和 Vercel（托管）搭建个人博客的完整流程如下：

一、准备工作

1. 安装依赖：

   • 安装 Node.js (LTS 版本)

   • 安装 Git

   • 安装 Hexo 命令行工具：

     npm install -g hexo-cli

2. 注册账号：

   • GitHub 账号（存放代码）
   • Vercel 账号（托管网站，支持 GitHub 登录）

---

二、本地搭建 Hexo 博客

1.初始化项目：

hexo init blog  # 创建项目
cd blog         # 进入目录
npm install        # 安装依赖

2.安装 安知鱼 主题：

git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

3.启用主题：
修改 _config.yml（站点配置文件）：

theme: anzhiyu

4.安装 pug 和 stylus 渲染插件

npm install hexo-renderer-pug hexo-renderer-stylus --save

5.覆盖配置

cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml

5.本地启动 hexo

hexo cl
hexo g
hexo s

访问 http://localhost:4000 查看效果。

---

三、上传github

1.创建github仓库：

用以下命名：

Abear6666.github.io 

2.修改_config.yml配置：

deploy:
 type: git
 repo: https://github.com/Abear6666/Abear6666.github.io
 branch: main

ps：记得前面也要带空格。Abear6666是你github的用户名

3.上传代码：

hexo cl&&hexo g&&hexo d

上传成功访问你github仓库会显示对应的文件信息。

访问链接：https://abear6666.github.io 即可云端访问你的博客网页

---

四、部署到 Vercel

1. 通过 Vercel 部署：
   • 登录 Vercel，（使用github账号登录）点击 Add New Project
   • 选择你的博客仓库，直接导入
   • 配置选项保持默认（Vercel 自动检测 Hexo）
   • 点击 Deploy，等待完成（约 1 分钟）
2. 访问网站：
   部署成功后，Vercel 会生成一个免费域名（如 your-blog.vercel.app），可通过该域名访问博客。
3. 配置域名（让国内网站能访问）

阿里云申请一个域名，使用个人备案即可,具体实现用以下教程：

hexo博客绑定域名实现国内访问_vercel国内访问-CSDN博客

---

五、博客美化（安知鱼主题）

---

六、图床

使用GitHub作为 免费图床 使用，搭配 jsDelivr CDN 加速访问，适合长期存储图片并用于 Markdown文件

https://cdn.jsdelivr.net/gh/用户名/仓库名@分支名/图片路径

CDN 缓存多久更新：

· jsDelivr 缓存约 10分钟~2小时。上传新图片后，若未生效可强制刷新

https://cdn.jsdelivr.net/gh/用户名/仓库@分支/图片路径?raw=true

配合Typora，picgo快速使用：

第一篇-Github+PicGo图床配置指南：Hexo 博客写作的高效插图解决方案_picgo快捷键设置-CSDN博客

Typora + PicGo + GitHub 配置图床——图片自动上传 详细教程_typora上传github-CSDN博客

Markdown引用：

![](https://i-blog.csdnimg.cn/img_convert/f48b55e5174eb2c292ea8e0d9be90395.png)

---

六、常用命令

功能	命令
新建文章	hexo new "标题"
本地运行	hexo clean && hexo s
生成静态文件	hexo generate
部署到 Vercel	git push（自动触发）

---

问题排查

部署网站后，我原本的源码如何更新，从新上传github管理？还是能直接在网站的源码管理？

我目前多使用一个仓库上传源码，方便自己多机器管理云端网页代码