Hexo 是一个快速、简洁且功能强大的静态博客框架。为了更高效地管理 Hexo 项目，我们需要了解其文件夹结构及各个目录的用途。本文将对 Hexo 的默认文件夹结构进行详细解析，帮助你快速熟悉 Hexo 项目目录。

Hexo 项目目录概览

初始化一个 Hexo 项目后，默认的目录结构如下：

1
2
3
4
5
6
7
8
9
.
├── _config.yml
├── package.json
├── node_modules/
├── public/
├── scaffolds/
├── source/
├── themes/
└── db.json

接下来，我们逐一分析这些文件和文件夹的作用。

顶层文件详解

_config.yml

Hexo 的全局配置文件，主要用于设置博客的基本信息和全局参数，例如：

  • 网站标题（title）
  • 博客地址（url）
  • 分页数（per_page）
  • 部署配置（deploy）

这是 Hexo 的核心文件，修改后需要重新生成静态文件才能生效。

package.json

记录了 Hexo 项目所需的依赖包和脚本命令，通常无需手动修改。常用命令包括：

  • npm install：安装项目依赖。
  • npm update：更新依赖包。

db.json

Hexo 的缓存文件，用于加快生成速度。如果缓存数据出错，可以删除该文件后重新生成。

文件夹详解

node_modules/

存放 Hexo 及其插件的依赖包。通过 npm install 安装的所有依赖都会存放在此处。通常无需手动修改，但不要随意删除。

public/

生成的静态文件目录，存放博客的 HTML、CSS、JS 等文件。此文件夹中的内容会被部署到服务器上。

注意：不要直接修改 public/ 文件夹中的内容，因为每次运行 hexo generate 或 hexo deploy 命令时，它都会被覆盖。

scaffolds/

模板文件夹，用于定义新建文章、页面等的默认结构。默认包含以下模板：

  • post.md：新建文章的模板。
  • page.md：新建页面的模板。
  • draft.md：新建草稿的模板。

自定义模板：可以修改这些文件，或添加新的模板以满足特定需求。

source/

存放博客的原始内容，包括文章、页面、资源文件等。

  • _posts/：存放文章文件，默认格式为 Markdown（.md）。
  • images/：可以存放图片等静态资源，也可以根据需要创建其他文件夹。

Hexo 会将 source/ 中的内容生成到 public/ 中，_posts 是主要的文章目录。

themes/

存放博客的主题文件夹。

  • 每个主题是一个独立的文件夹，包含布局（layout）、样式（CSS）、脚本等内容。
  • 默认主题是 landscape，通常会更换为第三方主题，如 Butterfly 或 NexT。

提示：主题切换需要修改 _config.yml 中的 theme 参数，并确保所选主题已正确安装。

常见自定义文件夹

scripts/

可以创建一个 scripts/ 文件夹，用于存放 Hexo 自定义脚本，扩展功能。例如批量修改文章标题或自动生成索引文件。

source/uploads/

如果需要在博客中添加大量图片或资源，可以创建 uploads 文件夹，方便管理。

文件夹管理建议

  1. 定期清理缓存：
    删除 db.json 和 .deploy_git 目录，运行 hexo clean 清理缓存。

  2. 备份重要文件：
    定期备份 _config.yml、source/ 和 themes/ 文件夹，避免数据丢失。

  3. 合理组织资源文件：
    将图片、附件等静态资源存放在 source/ 的子文件夹中，避免杂乱无章。

总结

Hexo 的文件夹结构简洁明了，各目录的分工明确。熟悉这些文件和文件夹的作用，可以帮助你更高效地管理博客项目。如果你有其他 Hexo 使用相关的问题或经验，欢迎留言分享！