在使用 Hexo 搭建博客时，我们会看到项目目录下自动生成了很多文件和文件夹。理解它们的作用有助于后续的维护与定制。这篇笔记记录一下各个核心文件/文件夹的作用。

🗂️ Hexo 项目结构说明

1
2
3
4
5
6
7
8
9
10
your-blog/
├── _config.yml
├── package.json
├── scaffolds/
├── source/
│   ├── _posts/
│   └── ...（你自定义的静态资源和页面）
├── themes/
├── public/
├── node_modules/

📄 _config.yml

  • Hexo 的主配置文件
  • 设置站点标题、语言、部署方式、主题名等信息

📄 package.json

  • Node.js 的项目配置文件
  • 记录 Hexo 的依赖插件与版本信息

📁 scaffolds/

  • 存放文章模板，如 post.md, page.md, draft.md
  • 创建文章或页面时会以此为基础

📁 source/

  • 存放用户的原始内容，如博客文章、图片、页面等
  • _posts/：博客文章（Markdown）
  • 其他目录：自定义页面或静态资源，如 about/、photography/

📁 themes/

  • 存放 Hexo 的主题文件
  • 每个主题一个文件夹，在 _config.yml 中通过 theme: 指定使用哪个

📁 public/

  • 存放 hexo g 命令生成的静态网站文件
  • 不建议手动修改，每次生成都会覆盖

📁 node_modules/

  • 存放通过 npm install 安装的依赖库
  • 一般不需要手动修改，.gitignore 会默认忽略它

🛠️ 小结

Hexo 是一个典型的“前端构建工具型”博客系统，掌握这些目录结构之后，就能灵活地扩展功能、添加页面或自定义主题。下一篇笔记将继续介绍如何添加自定义页面，如摄影作品集或留言板等。