HYM

security x life

安全技术与生活记录

04 // BLOG // 架构

为什么博客和 CMS 要坚持内容即代码

说明为什么在当前阶段,用 Markdown 文件和轻量发布界面比过早建设数据库型 CMS 更合理。

正文

正文内容来自本地 content/blog 目录,当前按构建时读取。

2026年5月17日架构1 分钟阅读安全、工程与生活方法的文章库

先从摩擦最小的系统开始

对于个人站来说,内容模型通常很小,也相对稳定。过早引入数据库、权限体系和富编辑后台,往往会先带来维护负担,而不是实际收益。

当前阶段更合适的版本可以保持得更轻:

  • Markdown 文件作为内容真源
  • Git 历史负责审阅和回滚
  • 后台路由只做一层很薄的发布辅助

这会立刻带来什么

当内容和代码同仓管理时,部署流和内容变更流是统一的。这样可以明显降低系统分裂、环境漂移和发布链路失配的概率。

content/blog/{locale}/{slug}.md
        -> 构建阶段解析
        -> 在对应语言路由中渲染
        -> 通过轻量 API 记录浏览和点赞

这不是最灵活的架构,但它是当前阶段在投入、控制力和迁移成本之间最划算的方案。

升级路径仍然保留

如果未来写作量上来,或者编辑协作流程变复杂,再引入更完整的 CMS 也完全来得及。先做内容即代码,并不会把后路堵死。

它只是避免在没有证据表明项目需要复杂系统之前,提前支付复杂度成本。

浏览与点赞

浏览

加载中

点赞

加载中

文章信息

内容路径

content/blog/zh/why-the-blog-and-cms-stay-content-as-code.md

分类

架构

阅读时长

1 分钟阅读

标签

MDXGitCMS
继续阅读

2026年5月20日

从功能完成到可以公开,个人站还差什么

记录这个站点从功能骨架进入真实内容阶段时,需要优先处理的页面可信度、内容密度和维护闭环。

2026年5月20日

从功能完成到可以公开,个人站还差什么

记录这个站点从功能骨架进入真实内容阶段时,需要优先处理的页面可信度、内容密度和维护闭环。

2026年5月19日

为什么这个网站同时写安全、旅途和训练

说明为什么这个个人网站不只做网络安全作品集,也保留旅途、训练和生活记录。

2026年5月18日

用终端风格做个人站,不等于牺牲可读性

记录如何在保留终端辨识度的同时,让页面仍然适合真实浏览、筛选和技术审阅。

2026年5月16日

把彩蛋做成系统,而不是散落的小把戏

从注册、触发、奖励和持久化角度说明,为什么彩蛋层必须按系统来设计。