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

博客搭建：

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

一、准备工作

  1. 安装依赖：

    • 安装 Node.js (LTS 版本)

    • 安装 Git

    • 安装 Hexo 命令行工具：

      1
      npm install -g hexo-cli

  2. 注册账号：

二、本地搭建 Hexo 博客

1.初始化项目：

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

2.安装 安知鱼 主题：

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

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

1
theme: anzhiyu

4.安装 pug 和 stylus 渲染插件

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

5.覆盖配置

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

5.本地启动 hexo

1
2
3
hexo cl
hexo g
hexo s

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

三、上传github

1.创建github仓库：

用以下命名：

1
Abear6666.github.io

2.修改_config.yml配置：

1
2
3
4
deploy:
 type: git
 repo: https://github.com/Abear6666/Abear6666.github.io
 branch: main

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

3.上传代码：

1
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文件

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

CDN 缓存多久更新：

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

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

配合Typora，picgo快速使用：

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

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

Markdown引用：

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

image-20250618164942390

六、常用命令

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

问题排查

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

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