Library Decap-CMS 基于Git仓库的静态站内容管理

一、项目介绍

用静态站点生成器（Hugo、Jekyll、Next 等）做网站，内容更新最麻烦的是“要么改 Markdown、要么自己写后台”：非技术同事根本不会提交 Git，你也不想为内容维护专门搭一套重后台。
Decap CMS（原 Netlify CMS）是一套对接 Git 仓库的内容管理系统。它在你的站点 /admin 下提供一个简洁编辑界面，作者登录后直接增删改内容，变更以 Markdown/数据文件形式提交回仓库，由静态生成器重新构建，无需自建数据库。

二、项目基本信息

三、核心优势

• 内容存进 Git 仓库，版本可追溯
• 编辑界面简洁，非技术作者也能用
• 支持多种静态生成器与托管
• 用 YAML 声明内容模型，灵活可控
• 开源 MIT，可自托管不绑定平台

四、适用场景

适合用静态站点生成器建站、希望给编辑/运营提供可视化后台、又不想引入数据库与重后端的团队。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 方式一：CDN 引入，单个 HTML + 配置文件即可
# 在 /admin/index.html 中引用 decap-cms 的 JS，并新建 config.yml
# 方式二：通过 npm 安装以获得构建期集成
npm install decap-cms

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# config.yml 声明内容集合（示例）
backend:
  name: github
  repo: your-name/your-site
media_folder: "static/images/uploads"
collections:
  - name: "posts"
    label: "文章"
    folder: "_posts"
    fields:
      - { name: title, label: 标题, widget: string }
      - { name: body, label: 正文, widget: markdown }

七、常见问题

问：内容存在哪？答：以文件形式提交进你的 Git 仓库，由静态生成器读取。问：需要服务器吗？答：不需要数据库；编辑界面作为静态页面部署即可。

八、总结

Decap-CMS 用一个清晰的设计，把把通用能力收成可复用的底座这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。