好的，我来帮你梳理一个 Hexo 从零开始搭建完整博客的完整流程，包含环境准备、安装、主题配置、发布流程，适合初学者。

1. 环境准备

  1. 安装 Node.js
    • Hexo 是基于 Node.js 的，需要先安装 Node.js（建议 LTS 版本）。
    • 官方地址：https://nodejs.org/
    • 安装完成后可验证：node -v npm -v
  2. 安装 Git
  3. 准备 GitHub/Gitee 账户（可选）
    • 如果想部署到 GitHub Pages 或 Gitee Pages，需要一个账号并创建仓库。

2. 安装 Hexo

  1. 全局安装 Hexonpm install -g hexo-cli
  2. 创建博客目录hexo init my-blog cd my-blog npm install
    • hexo init 会生成默认博客框架，包括 source、themes、_config.yml 等文件。
  3. 启动本地预览hexo server

3. 配置博客

  1. 全局配置 _config.yml
    • 包含博客标题、作者、URL、语言等信息：title: 我的博客 subtitle: 技术与生活 description: 一个记录技术和生活的博客 author: 李若萱 language: zh-CN
  2. 选择主题
    • Hexo 官方默认主题是 landscape，也可以换成第三方主题：
    • 下载主题：git clone https://github.com/username/theme-name themes/theme-name
    • 修改 _config.yml 中 theme 字段：theme: theme-name
  3. 自定义主题配置
    • 大部分主题在 themes/theme-name/_config.yml 中可配置：
      • 导航栏、侧边栏、社交链接、文章摘要等。

4. 撰写文章

  1. 新建文章hexo new "我的第一篇文章"
    • 在 source/_posts/ 目录下会生成一个 Markdown 文件：--- title: 我的第一篇文章 date: 2025-09-02 09:00:00 tags: - Hexo categories: - 教程 --- 这里写文章内容...
  2. 本地预览文章hexo server
    • 修改后刷新页面即可看到效果。

5. 生成静态文件

hexo generate
  • 或简写：
hexo g
  • 会在 public/ 文件夹生成静态网页文件。

6. 部署博客

  1. 安装部署插件npm install hexo-deployer-git --save
  2. 配置 _config.yml 部署deploy: type: git repo: https://github.com/username/repo.git branch: main
  3. 部署到 GitHub Pageshexo clean hexo deploy
    • 部署完成后，GitHub Pages 就能访问博客了。

7. 高级优化（可选）

  • SEO 优化：添加 meta 标签、Sitemap 插件
  • 评论系统：如 Valine、Giscus
  • Pjax 加速：无刷新加载页面
  • 静态资源 CDN：加速图片、JS、CSS
  • 自动化部署：GitHub Actions / GitLab CI

总结

Hexo 的流程可以概括为：
安装环境 → 初始化博客 → 配置主题 → 撰写文章 → 生成静态网页 → 部署上线

一旦熟悉了流程，写博客、更新文章、部署都可以非常高效。