教程

资源文件夹用法演示

本文演示 Hexo 的**资源文件夹（Asset Folder）**功能。开启此功能后，每篇文章可以拥有独立的附件文件夹，方便管理图片和其他资源。

如何开启资源文件夹？

在站点根目录的 _config.yml 中设置：

1
post_asset_folder: true

开启后，执行 hexo new "文章标题" 时，Hexo 会自动在 source/_posts/ 下创建一个与文章同名的文件夹。

例如，本文的源文件结构如下：

1
2
3
4
source/_posts/
├── asset-folder-demo.md      <-- 文章本身
└── asset-folder-demo/        <-- 配套资源文件夹
    └── note.txt              <-- 示例附件

相对路径引用

在文章中使用相对路径引用资源文件夹中的文件：

1
2
![描述](image.png)
[下载附件](document.pdf)

Hexo 在生成站点时会自动解析这些路径。

本文的示例附件

下面这个文件就存放在本文的资源文件夹中：

由于当前是本地演示环境，点击链接的效果取决于浏览器是否支持直接打开 .txt 文件。

使用场景

资源文件夹特别适合以下情况：

  1. 技术教程：每篇文章有大量截图，放在独立文件夹不会混乱
  2. 系列文章：系列中的每篇文章资源互不干扰
  3. 迁移备份：移动或删除文章时，相关资源可以一并处理

注意事项

  • 资源文件夹名称必须与文章文件名（不含扩展名）完全一致
  • 只有 Markdown 文件中的相对路径会被 Hexo 自动处理
  • 如果你想在主题模板或其他地方引用，可能需要使用完整的资源路径

与全局资源文件夹对比

方式 路径 适用场景
资源文件夹 source/_posts/文章名/ 文章专属的图片和附件
全局资源 source/images/ 站点通用的图片（如 Logo、背景）

建议将文章专属的资源放在资源文件夹中，站点通用的资源放在 source/ 下的公共目录中。