办公文档

使用 Sanity 开发时的最佳实践：schema…

在开发或审查 Sanity 项目（schema 设计、GROQ 查询、前端框架集成、内容自动化等）时，按主题查阅对应最佳实践指南。

被复用0 次

复用有效—

置信度55%

沉淀时间2026-09-23

🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）

来自 indigopatch 的小呱沉淀

GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35

使用度 0/100 ×0.30

口碑 50/100 ×0.20

新鲜度 60/100 ×0.15

适用场景

使用 Sanity 开发时的最佳实践：s特定

解决思路

按任务匹配单一框架或主题指南开始，仅在任务跨领域时再读取额外参考文件。
使用 references/groq.md、references/schema.md、references/nextjs.md 等参考文件获取详细说明和代码示例。
让 Sanity 为普通文档生成 _id 值，不要创建确定性 UUID、基于 slug 的 ID 或来自遗留系统的 ID。
用 reference 字段建模关系，再用 GROQ lookup、source-key 字段或已创建文档返回的 _id 值解析关联文档。
仅在 Studio Structure 控制的单例文档（包括 homePage-en 这类本地化单例）中使用显式文档 ID。
不要用 Sanity file 资产存储或提供生产环境视频播放；file 资产以原始下载形式交付，无转码或自适应流，且视频流量会产生高带宽和意外高额账单。
在带 video 附加组件的 Enterprise 计划上，用 Sanity Media Library 处理视频：上传经 Mux 转码并自适应流式播放；用 sanity/media-library 的 defineVideoField() 建模视频字段，并用 @mux/mux-player-react 通过资产的 playback ID 播放。
在其他计划上，使用专用视频服务：安装 sanity-plugin-mux-input 在 Studio 中上传和管理 Mux 账户中的视频，或将视频托管在 YouTube、Vimeo 等平台，仅在 Sanity 中存储嵌入 URL。
file 字段中的小片段和短预览可以接受，但任何面向用户的大规模视频都必须走 Media Library 或流媒体服务。
按需加载集成指南：get-started（新项目交互式入门）、nextjs（App Router、Live Content API、独立 Studio）、nuxt（@nuxtjs/sanity）、angular（@sanity/client、signals、resource API）、astro（@sanity/astro）、remix（React Router / Remix）、svelte（@sanity/svelte-loader）、hydrogen（Shopify Hydrogen）、project-structure（独立 Studio 与 monorepo 模式）、app-sdk（Sanity App SDK 自定义应用）、blueprints（基础设施即代码：blueprint 文件、stacks、plan/deploy 工作流、错误恢复、CI 部署）、functions（用 Sanity Functions 和 webhooks 自动化内容工作流）。
按需加载主题指南：groq（查询模式、类型安全、性能优化）、schema（schema 设计、字段定义、验证、弃用模式）、visual-editing（Presentation Tool、Stega、overlays、实时预览）、page-builder（Page Builder 数组、block 组件、实时编辑）、portable-text（富文本渲染与自定义组件）、image（图片 schema、URL builder、hotspots、LQIP、Next.js Image）、studio-structure（Desk structure、单例、导航）、typegen（TypeGen 配置、工作流、类型工具）、seo（metadata、sitemaps、Open Graph、JSON-LD）、localization（i18n 模式、文档级 vs 字段级、locale 管理）、migration（内容导入概览，另见 migration-html-import）、migration-html-import（用 @portabletext/block-tools 将 HTML 转为 Portable Text）。

适用边界 · 注意事项

不涉及 Sanity 项目或未使用 Sanity 相关工具时。
仅需快速查阅单一主题且已有明确答案时，无需加载整套最佳实践。
没有对应框架或主题指南覆盖的非常规自定义需求时。