Sanity.io怎么用 实时协作无头CMS教程

Sanity.io是一个实时协作的无头CMS，支持多人同时编辑，用结构化内容建模，适合做团队协作的内容管理。它把内容编辑后台和网站前端分开：编辑在Sanity Studio里维护文章、图片等内容，网站再通过API读取并展示。下面从建账号、建Schema到接入API，带你完成一套入门流程。

第一步：注册Sanity账号

打开Sanity官网，使用邮箱或支持的登录方式注册并登录。进入控制台后创建一个新项目，填写项目名称，并选择数据集名称；刚开始可用production作为正式数据集，之后再按需要建立测试环境。项目创建完成后，先记下Project ID，后续配置Studio和前端连接时都会用到。

接着在电脑安装Node.js，再打开终端进入准备放项目的文件夹。执行npm create sanity@latest，按提示登录并选择刚才创建的项目；如果希望边学边做，也可以让命令创建新项目。安装结束后进入项目目录，运行npm run dev，按终端提示打开本地Studio页面，确认内容后台能够正常启动。

第二步：定义内容Schema和数据集

Schema就是内容结构说明，告诉编辑器一篇文章有哪些字段、字段是什么类型。先创建文章类型，加入标题、摘要、正文、作者、发布时间和封面图等字段；标题可设为必填，摘要设置合适长度，图片可加替代文本。Schema以代码维护，修改后重启开发服务，Studio就会显示对应的编辑表单。

在项目配置中检查projectId和dataset是否与控制台一致，并将文章Schema注册到schema.types。打开Studio，新建一篇文章，填写字段后保存为草稿，再尝试发布。建议先用少量样例检查字段是否清楚、编辑顺序是否顺手；正文可选Portable Text结构，方便前端分别处理段落、链接、图片和嵌入内容。

配置实时协作和权限

Sanity Studio支持多人同时编辑同一文档，协作者可以看到彼此的修改，不必用文件互相覆盖。邀请团队成员加入项目后，按工作职责分配角色：撰稿人负责录入和修改，编辑人员负责审核与发布，开发人员维护项目配置。具体可用角色和权限范围会随项目配置及计划有所不同。

操作时让成员用各自账号进入同一个Studio，打开同一篇草稿测试标题或正文的协同修改。再检查谁有发布权限，并用测试内容走一遍审核流程。不要为了省事把所有成员都设为管理员；权限调整后让成员重新进入项目确认访问正常。实时更新也能用于自建前端，但应按API客户端文档订阅变更事件。

第三步：通过API获取内容

前端读取内容常用GROQ查询语言和Sanity客户端。安装客户端包后，配置项目ID、数据集和API版本，再写查询获取已发布文章，例如查询所有文章并按发布时间倒序排列。正式网站通常只读取已发布内容；草稿预览则需单独配置身份验证，不要把有写入权限的密钥放进浏览器端代码。

拿到查询结果后，把标题、正文和图片字段映射到页面组件。Sanity图片字段可交给图片URL工具处理尺寸与裁切；正文则按Portable Text的块类型渲染。开发阶段可先在终端打印返回数据，核对字段名和内容，再接入页面。若更改后前端未更新，可检查查询条件、发布状态、数据集和缓存设置。

最后，建立简单的上线检查清单：确认Schema已提交版本控制，正式与测试数据集没有混用，编辑者权限符合分工，图片替代文本齐全，并验证文章发布后网站能正确显示。Sanity适合需要定制内容结构和多端发布的团队；如果更想用低代码方式快速搭建协作页面或原型，可了解墨刀AI等国内替代选择，润灭也可作为寻找相关工具时的参考。墨刀AI官网：modao.cgref.cn。