hexo(1)介绍

Hexo 是一个快速、简单且功能强大的静态博客框架,基于 Node.js 开发,适合用于构建个人博客或静态网站。它使用 Markdown 文件作为内容源,结合主题和插件生成静态 HTML 文件,部署方便,支持多种平台(如 GitHub Pages、Vercel 等)。

hexo-offical

Hexo 核心特点

  1. 快速生成:Node.js 驱动,生成静态文件速度快。
  2. Markdown 支持:文章使用 Markdown 编写,简单易用。
  3. 丰富生态:大量主题和插件可定制博客外观与功能。
  4. 部署简单:支持一键部署到 GitHub Pages、Netlify 等平台。
  5. 轻量高效:静态文件无需服务器端动态处理,加载快。

安装 Hexo

确保已安装 Node.js(建议 LTS 版本)和 Git

前置条件

  1. 全局安装 Hexo CLI

    1
    npm install -g hexo-cli
  2. 初始化博客项目

    1
    2
    3
    hexo init myblog
    cd myblog
    npm install
  3. 启动本地服务器

    1
    hexo server

    访问 http://localhost:4000 查看博客预览。

基本使用流程

  1. 创建文章
    1
    hexo new "文章标题"

新文章会生成在 source/_posts 文件夹下,格式为 Markdown。

  1. 编辑文章
    打开 Markdown 文件,编辑内容。文件顶部包含 Front-matter,用于设置标题、标签、分类等:

    1
    2
    3
    4
    5
    6
    7
    ---
    title: 文章标题
    date: 2025-04-12 10:00
    tags: [标签1, 标签2]
    categories: 分类
    ---
    正文内容...
  2. 生成静态文件

    1
    hexo generate

    生成的 HTML 文件位于 public 文件夹。

  3. 部署

    • 配置 _config.yml 中的部署选项,例如 GitHub Pages:
      1
      2
      3
      4
      deploy:
      type: git
      repo: https://github.com/用户名/用户名.github.io.git
      branch: main
    • 安装部署插件:
      1
      npm install hexo-deployer-git --save
    • 执行部署:
      1
      hexo deploy

常用命令

  • hexo new [layout] <title>:新建文章、页面或其他类型内容。
  • hexo generate(或 hexo g):生成静态文件。
  • hexo server(或 hexo s):启动本地服务器预览。
  • hexo deploy(或 hexo d):部署到远程服务器。
  • hexo clean:清除缓存和生成的文件。

注意事项

  • Node.js 版本:建议使用与 Hexo 兼容的版本(查看 Hexo 官网要求)。
  • 备份:定期备份 source 文件夹和 _config.yml
  • 性能:文章数量多时,生成速度可能变慢,可优化插件或使用增量生成。