如果你用過SurrealDB，一定體會過這種痛：本地開發(fā)時表結構改來改去，字段增刪、索引調整，沒過多久數據庫狀態(tài)和代碼預期就對不上了。SurrealDB團隊官方推出的SurrealKit，正是為了解決這個Schema管理難題。

SurrealKit是一個CLI工具，通過.surql文件來管理數據庫結構。你把表定義、索引、訪問規(guī)則寫成文件，工具負責讓數據庫和文件保持一致。它主要分兩種模式：本地開發(fā)用sync（同步），推到共享環(huán)境時用rollouts（ rollout部署）。

安裝很簡單。用Rust的Cargo包管理器直接裝：cargo install surrealkit。不想編譯的話，GitHub releases頁面有預編譯二進制文件。

裝好后在項目里執(zhí)行surrealkit init，會創(chuàng)建一個/database目錄，里面搭好基礎框架。工具通過環(huán)境變量連數據庫，在.env文件里配這幾項：SURREALDB_HOST、SURREALDB_NAME、SURREALDB_NAMESPACE、SURREALDB_USER、SURREALDB_PASSWORD。它同時支持DATABASE_HOST和PUBLIC_DATABASE_HOST兩種變量名，如果你用SvelteKit這類把環(huán)境變量分可見性的框架，這個設計能省不少事。

Schema文件放在database/schema/目錄下，每個.surql文件里寫表定義、索引、訪問規(guī)則——就是你平時寫的SurrealQL。文件怎么組織完全由你決定，可以一表一個文件，也可以把相關的放一起。SurrealKit會追蹤這些文件的內容，和實際數據庫狀態(tài)做比對。

改完Schema要生效，執(zhí)行surrealkit sync即可。工具會比對文件和數據庫的差異，只應用變更。如果你從文件里刪了一張表的定義，它也會從數據庫里刪掉。兩邊始終保持一致。

實際開發(fā)中更常用的是watch模式：surrealkit sync --watch。這個命令會監(jiān)聽database/schema/目錄，文件一保存就自動重新同步，刪除操作也能自動處理，不需要手動干預。

sync模式適合本地數據庫——你擁有完全控制權，刪改都沒關系。但推到共享環(huán)境時就得換思路了，rollouts模式能幫你做更可控的Schema遷移。這個工具把SurrealDB原本靈活的Schema管理，變成了可版本控制、可自動化的工作流。