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。