Hexo 博客搭建指南

1
2
3
4
5
6
7
8
9
10
# Hexo 博客搭建指南

## 基础命令
```bash
hexo init       # 初始化博客项目
npm install     # 安装依赖（非hexo install）
hexo g          # 生成静态文件（generate）
hexo s          # 本地预览（server）
hexo cl         # 清除缓存（clean）
hexo d          # 部署到GitHub（deploy）

首次部署准备

  1. 安装Git部署插件：

    1
    npm install hexo-deployer-git --save

  2. 修改 _config.yml：

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://github.com/用户名/仓库名.git  # 从GitHub复制的HTTPS链接
      branch: main  # 或master（根据仓库设置）

文章管理

1
hexo new "文章标题"  # 创建新文章
  • 文章路径：source/_posts/文章标题.md

主题配置（Butterfly示例）

1
2
3
4
5
6
# _config.yml 中设置
theme: butterfly

# 主题配置优先级：
# _config.butterfly.yml > 主题默认配置
# 建议复制主题的_config.yml到根目录并重命名

部署平台

推荐部署到：

DNS解析示例（Cloudflare）

1
2
3
原DNS记录：
ganz.ns.cloudflare.com  
vita.ns.cloudflare.com

工作流程

  1. 写作：hexo new → 编辑.md
  2. 测试：hexo s
  3. 发布：hexo g -d （生成并部署）
  4. 清理：hexo cl （遇到问题时使用）

提示：每次修改配置后建议执行 hexo cl && hexo g 确保更改生效
```