hexo操作
#技巧#HEXO 2025-01-05

Hexo常用命令详细梳理

一、引言

Hexo是一个快速、简洁且高效的博客框架，使用它可以方便地创建和管理个人博客。在使用Hexo的过程中，掌握常用的命令是非常重要的，这些命令能够帮助我们完成从创建文章、生成静态文件到部署网站等一系列操作。

## 二、Hexo安装与初始化

在开始使用Hexo命令之前，需要先安装Hexo并进行初始化。

假设你已经安装了Node.js和Git，执行以下命令安装Hexo：

1
npm install -g hexo-cli

安装完成后，在指定的文件夹中初始化Hexo项目：

1
hexo init <blog-folder> cd <blog-folder> npm install

其中，<blog-folder>是你想要创建博客项目的文件夹名称。

三、常用命令详解

（一）创建文章

  1. 基本命令格式

    1
    hexo new [layout] <title>

    其中，<title>是文章的标题，[layout]是文章的布局（默认为post，可在_config.yml中配置）。

  2. 示例 创建一篇名为“我的第一篇Hexo文章”的普通文章： hexo new "我的第一篇Hexo文章" 这将在source/_post文件夹下创建一个我的第一篇Hexo文章.md文件，用于编写文章内容。

  3. 常用参数 - -p或--path：自定义新文章的路径。例如，创建一个位于source/about/me.md的页面文件（假设布局为page）： hexo new page --path about/me "关于我" - -r或--replace：如果存在同名文章，则替换它。例如，重新创建同名文章： hexo new --replace "我的第一篇Hexo文章" - -s或--slug：指定文章的slug，作为新文章的文件名和发布后的URL部分。例如： hexo new --slug custom-slug "自定义Slug文章" 这将创建一个名为custom-slug.md的文件。

（二）生成静态文件

  1. 基本命令格式
1
hexo generate

或简写为 hexo g 作用是将源文件（如Markdown格式的文章）转换为可在Web服务器上直接访问的静态HTML、CSS、JavaScript等文件。

  1. 常用参数

    • -d或--deploy：在文件生成后自动部署网站。例如： hexo g -d 这将先生成静态文件，然后自动部署到配置的部署目标（如GitHub Pages等）。

    • -w或--watch：监视文件变动，当文件发生更改时自动重新生成静态文件。在开发过程中，当你修改了文章内容或主题文件后，保持hexo g -w命令运行，Hexo会自动检测到变化并重新生成静态文件，方便实时预览效果。

    • -b或--bail：若在生成过程中出现异常则抛出错误并停止生成。如果在生成静态文件时遇到问题，使用这个参数可以快速定位错误原因。

    • -f或--force：强制重新生成文件，忽略缓存。当你修改了配置文件或主题文件，并且希望确保生成的文件是最新的，可以使用这个参数。

    • -c或--concurrency：指定最大同时生成文件数量，默认无限制。如果你的电脑性能较好，可以适当提高这个值来加快生成速度，但如果设置过高可能会影响电脑性能。

      例如，设置同时生成文件数量为5： hexo g -c 5

（三）部署网站

  1. 基本命令格式
1
hexo deploy

或简写为 hexo d

  1. 作用 将生成的静态文件部署到远程服务器或指定的部署目标（如GitHub Pages、Netlify等）。
  2. 常用参数 - -g或--generate：在部署之前先执行生成静态文件操作，等同于先执行hexo g。这是一个很常用的参数组合，确保部署的是最新的内容： hexo d -g

### （四）清除缓存文件

  1. 基本命令格式
1
hexo clean

​ 2. 作用 清除Hexo生成的缓存文件，如生成的静态文件、数据库缓存等。在更新主题、修改配置文件或遇到一些奇怪的问题时，执行此命令可确保生成的文件是最新的。例如，当你切换了Hexo主题后，先执行hexo clean，然后再重新生成和部署网站，以避免旧缓存文件对新主题的影响。

（五）启动服务器

  1. 基本命令格式 hexo server 或简写为 hexo s
  2. 作用 启动本地服务器，用于预览博客网站效果。启动后，通过在浏览器中输入http://localhost:4000/即可访问本地站点。按ctrl+c可结束服务器运行。在撰写文章或修改主题样式后，使用hexo s启动服务器，可以实时查看修改后的效果，方便调试和优化。

### （六）发布草稿

  1. 基本命令格式 hexo publish [layout] <filename> 其中，<filename>为草稿文章的文件名（不包含路径）。
  2. 示例 假设你有一篇草稿文章名为draft-article.md，将其发布为正式文章： hexo publish post draft-article 这将把草稿文章移动到source/_post文件夹下，并使其可以在网站上显示。

（七）渲染文件

  1. 基本命令格式 hexo render <file1> [file2]
  2. 作用 渲染指定的文件，将其转换为可在浏览器中正确显示的格式（如将Markdown文件渲染为HTML）。
  3. 常用参数 - -o或--output：设置渲染后的文件输出路径。例如，将一个Markdown文件渲染为HTML并输出到指定文件夹： hexo render source/_post/my-article.md -o public/my-rendered-article.html

（八）列出网站资料

  1. 基本命令格式 hexo list <type> 其中，<type>可以是post（文章）、page（页面）、category（分类）、tag（标签）等。
  2. 示例 列出所有文章： hexo list post 列出所有分类： hexo list category 这有助于你快速查看和管理网站的各种资料。

### （九）显示草稿

  1. 基本命令格式 hexo --draft （此处原文档中的--deaft疑似笔误，应为--draft）
  2. 作用 显示草稿状态的文章列表，方便查看和管理未发布的文章。

（十）自定义当前工作目录

  1. 基本命令格式 hexo --cwd /path/to/cwd
  2. 作用 指定Hexo命令执行时的当前工作目录，可用于在不同目录下管理多个Hexo站点或在特定目录下执行Hexo操作。例如，你有两个Hexo项目分别位于/blog-project1和/blog-project2，当你在/blog-project2目录下时，想要执行/blog-project1中的Hexo命令，可以使用： hexo --cwd /blog-project1 <command> 其中<command>是具体的Hexo命令，如hexo g、hexo s等。