hexo 日常使用

Posted on

Hexo 是一个基于 Node.js 的快速、简洁且高效的静态博客框架，使用 Markdown 或其他标记语言撰写文章，几秒内即可生成静态网页。以下是 Hexo 的基本使用流程，适用于初学者快速上手。

一、安装前提
在安装 Hexo 前，需先安装以下两个工具：

  • Node.js（建议 12.0 或更高版本）
  • Git（用于部署到 GitHub 等平台）

可通过命令行验证是否已安装：

1
2
node -v
git --version

二、安装 Hexo

  1. 全局安装 Hexo CLI：

    1
    npm install -g hexo-cli

  2. 创建博客目录（必须为空）：

    1
    mkdir myblog && cd myblog

  3. 初始化 Hexo 站点：

    1
    hexo init

  4. 安装依赖包：

    1
    npm install

三、常用命令速查

  • 生成静态文件： 

    1
    hexo generate

  • 启动本地服务器（默认端口 4000）： 

    1
    hexo server

    访问：http://localhost:4000

  • 新建文章： 

    1
    hexo new "文章标题"

    文章保存在 source/_posts/ 目录下。

  • 新建页面（如关于页）： 

    1
    hexo new page about

  • 部署到远程仓库（如 GitHub Pages）： 

    1
    hexo deploy

  • 清理缓存与生成文件： 

    1
    hexo clean

更多命令详见官方文档：Hexo Commands

四、配置部署（以 GitHub Pages 为例）

  1. 在 _config.yml 中配置部署信息：

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://github.com/你的用户名/你的用户名.github.io.git
      branch: main

  2. 安装 Git 部署插件：

    1
    npm install hexo-deployer-git --save

  3. 生成并部署：

    1
    hexo g -d

  4. 访问你的博客：
    https://你的用户名.github.io

五、更换主题（可选）

  1. 下载主题到 themes/ 目录，例如：

    1
    git clone https://github.com/yelog/hexo-theme-3-hexo.git themes/hexo-theme-3-hexo

  2. 修改 _config.yml 中的 theme 字段：

    1
    theme: hexo-theme-3-hexo

  3. 清理并重新生成：

    1
    hexo clean && hexo g && hexo s

主题市场：Hexo Themes

六、写作与资源管理

  • 文章使用 Markdown 编写，支持 Front Matter（如标题、日期等）。
  • 启用文章资源文件夹（自动为每篇文章创建资源文件夹）：
    1
    2
    _config.yml
    post_asset_folder: true
  • 引用图片推荐使用标签插件：
    1
    {% asset_img example.jpg "示例图片" %}

详情见：写作指南

七、常见问题

  • 权限错误（EACCES）：建议使用 nvm（Node 版本管理器）安装 Node.js 。
  • 中文乱码：确保文件保存为 UTF-8 编码。
  • 部署失败：检查 Git 配置和仓库地址是否正确。

如需完整实战教程，可参考：CSDN Hexo 完整使用指南 。