Hexo 博客搭建教程

Hexo 是一个快速、简洁且高效的静态博客生成框架，基于 Node.js 开发。

准备工作

我们正身处人工智能蓬勃发展的时代。因此，当你遇到技术问题时，不妨请先向ChatGPT、DeepSeek、Kimi等AI工具寻求帮助，它们或许能为你解答大部分疑问。

安装 node.js

打开node.js官网下载

引用站外地址

Node.js

https://nodejs.org/zh-cn

node.js会送npm的

安装git

打开Git官网下载

引用站外地址

git

https://git-scm.com/install/

WindowsmacOSLinux

Windows安装教程
下载 64-bit Git for Windows Setup。
下载完成后运行.exe 文件。在安装过程中，可以一路点击 “Next”

MacOS通常自带Git。你也可以通过 Xcode 安装。或是Homebrew 安装：安装Homebrew 运行命令：brew install git

Linux可以直接使用自带的包管理器，非常快捷。
Linux安装

验证安装

选择一个位置，新建文件夹（注意：路径中尽量不要包含中文字符）例如 HEXO ，该文件夹之后会被用来存放博客的所有文件。在文件夹的根目录打开终端，输入以下命令验证安装：

node -v
npm -v
git --version

安装Hexo

在终端中依次输入以下命令安装Hexo

npm install hexo-cli -g
hexo init
npm install hexo-deployer-git --save

可能会遇到网络问题，就多试几次

安装完成之后，就会出现相关文件。

• HEXO/
  • _config.yml：站点配置文件（核心配置）
  • package.json：依赖信息
  • scaffolds/：模板文件夹
  • source/：资源文件夹
    • _posts/：文章存放目录
    • _drafts/：草稿存放目录
  • themes/：主题文件夹

本地浏览

终端输入

hexo g
hexo s

随后在浏览器访问 http://localhost:4000/
看到如下页面说明安装成功

更换主题

Hexo 默认的主题过于简单，Hexo 提供丰富的主题选择，从简约优雅到功能丰富，应有尽有。

butterfly主题

一个适用于 Hexo 的现代化、美观且功能丰富的主题

https://butterfly.js.org/

AnZhiYu主题

一个简洁、美丽的静态hexo主题

https://docs.anheyu.com/

Stellar主题

一个简约商务风 Hexo 主题
https://xaoxuu.com/wiki/stellar/#start

solitude主题

Solitude 是一个极简而优雅的 Hexo 主题，专为开发人员和作家设计。
https://solitude.js.org/

Aurora主题

主题的主要设计理念是基于当下流行的 “极光UI”。

https://aurora.tridiamond.tech/cn/

温馨提醒

主题千万个，文档第一步，步骤不规范，运行两行泪

安装主题

这里以 Butterfly 主题为例：
终端执行

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

修改根目录下的_config.yml，大概在99行处，把theme修改为butterfly

同时安装pug 以及 stylus 的渲染器

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

同时建议在 hexo 的根目录创建一个文件_config.butterfly.yml，并把主题目录的_config.yml内容复制到_config.butterfly.yml 去。

终端执行

hexo cl && hexo g && hexo s

内容创作

创建文章

终端执行

hexo new "文章标题"

在 source/posts目录下生成一个Markdown 文件。
使用 Markdown 语法，你可以用Typora、VS Code 等编辑器打开它，编写内容

更新博客

终端执行

hexo cl && hexo g && hexo s

部署上线

我们要利用 GitHub Pages 免费托管博客。

创建 GitHub 仓库

登录 GitHub，新建一个仓库。
仓库名必须是： 你的用户名.github.io 
我的用户名是 Zeora315 ，仓库名就是 Zeora315 .github.io 
确保仓库是公开的（Public）

配置 SSH 密钥

获取公钥

终端输入

ssh-keygen -t rsa -C "yourname@example.com" 

注意将 yourname@example.com 替换为你的 GitHub 注册邮箱

默认会使用系统提供的路径：

/Users/yourname/.ssh/id_rsa

如果你希望将密钥保存在其他位置，可以输入自定义路径

一路回车，如下图

cd ~/.ssh
cat id_rsa.pub

进入SSH目录，然后查看SSH公钥

GitHub设置中添加公钥

进入GitHub settings页面，找到SSH and GPG Keys，点击New SSH key，

粘贴密钥，点击添加

配置部署信息

进入刚才创建的仓库，复制ssh

在 config.yml 中找到deploy

deploy:
  type: git
  repository: git@github你刚才复制的
  branch: main

然后终端执行

hexo cl && hexo g && hexo d

🎉大功告成！
然后访问 https://yourname.github.io/ 看一下效果吧。

Vercel部署

对于个人开发者，vercel的每月配额为：100GB 的带宽、6000 分钟的构建时长，每天 10 万次的边缘请求调用。100GB的流量对于个人使用来说，应该是相当相当相当充裕的。

注册Vercel

打开官网 https://vercel.com/
直接点击 Continue with GitHub 进行注册

导入项目

进入控制台后，点击 Add New… ，选择 Project，进入以下页面，搜索你的仓库，选择import。

自定义域名

由于Vercel 的默认域名 .vercel.app在内地被墙了，所以建议自定义域名。

Vercel 控制台进入 Settings，找到Domains，Add添加域名。

常用指令

hexo generate简写hexo g 生成静态文件
hexo server简写hexo s 启动本地服务器
hexo deploy简写hexo d 部署网站
hexo clean简写hexo cl 清除缓存和已生成的静态文件。

hexo cl && hexo g && hexo s

这条代码的意思是：先清理缓存，如果清理成功，则生成网页文件，如果生成成功，则启动本地服务器。

如果你需要更详细的信息，可以使用 hexo help 查看所有可用指令，或者访问 Hexo指令文档。

写在最后

当所有人都在追逐即时反馈，选择写博客就是选择一种慢节奏的表达。它既不讨好算法，也不追求爆款，只服务于那些愿意花时间阅读的人。