为什么这次直接按目录组织一篇内容

个人站点最常见的一种拖累，是一开始为了快，把所有内容都平铺成一个个孤立文件。等真正开始加图片、草图、封面、多个语言版本时，目录就会迅速变难看，也难管理。

平铺文件的问题不是“丑”，而是容易让关系断掉

单文件结构在最开始当然更轻，但它很快会遇到这些问题：

• 同一篇文章的封面图和正文不在一起
• 多语言版本之间只能靠人工记忆对应关系
• 一旦有附件或补充材料，不知道该放哪
• 删除或迁移内容时很容易遗漏关联文件

这些问题不需要几百篇内容才会出现，十几篇内容加几张图就已经足够了。

目录式组织的好处非常直接

现在一篇内容可以这样放：

content/blog/zh/organizing-content-by-entry-folder/
  index.mdx
  cover.png
  diagram.svg
  notes.md

对于以后要加图、要拆版本、要归档附件的站点来说，这比平铺文件更容易维护，也更不容易出错。

Next.js 本身需要额外做什么吗

对于当前这类基于 App Router、手动导入 MDX 的个人站点来说，目录化本身并不需要额外的 Next.js 路由配置。

真正需要处理的是“你如何发现内容”。

在这个项目里，做法很简单：通过内容注册表手动声明哪些目录会被发布。这样既保留了目录式组织的好处，也避免过早引入更复杂的自动扫描方案。

这对私有知识库也一样成立

知识库虽然不公开，但完全可以沿用同样的方式组织。

这意味着以后无论是博客、项目，还是内部知识条目，你都可以用统一的心智模型来维护内容，而不是每种内容一套目录规则。