Hexo博客简介

Hexo 是一个基于 Node.js 的静态博客生成器，就像给你的文章找个"智能排版助手"。它能把 Markdown 文件自动转换成漂亮的网页，比传统博客快 10 倍以上，特别适合技术分享和个人日记。

准备工作

安装Nodejs

打开终端，依次执行：

sudo apt update
sudo apt-get install -y nodejs

安装完成后检查版本：

node -v  # 应该显示 v18.x 或更高
npm -v   # 应该显示 9.x 或更高

安装博客

安装Hexo

sudo npm install -g hexo-cli

启动Hexo

hexo init 文件夹名字
cd 文件夹名字
npm install

初始化后，您的项目文件夹将如下所示：

├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

编辑博客配置文件

编辑 _config.yml 文件：

title: 我的技术小站
subtitle: 记录学习点滴
description: 一个程序员的成长笔记
author: 你的名字
language: zh-CN

更换主题（以Butterfly为例）

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

然后在配置文件中修改：

theme: butterfly

写作与发布

新建文章

hexo new "我的第一篇文章"

文章会自动生成在 source/_posts/我的第一篇文章.md

本地预览

hexo server

浏览器访问 http://localhost:4000 就能看到效果

部署到GitHub

创建GitHub仓库

仓库名必须为：你的用户名.github.io

安装部署插件

npm install hexo-deployer-git --save

配置部署信息

在 _config.yml 末尾添加：

deploy:
  type: git
  repo: https://github.com/用户名/用户名.github.io
  branch: gh-pages

一键部署

hexo clean && hexo generate && hexo deploy

修改Github Pages运行目录

点开设置

找到Pages 并打开

点击Branch  分支，把/(Root)改为/docs

等待1-2分钟后，访问 https://你的用户名.github.io 就能看到线上博客啦！

提示：每天写博客前先执行 git pull 同步最新内容，养成好习惯哦！