如果你用過(guò)SurrealDB，一定體會(huì)過(guò)這種痛：本地開(kāi)發(fā)時(shí)表結(jié)構(gòu)改來(lái)改去，字段增刪、索引調(diào)整，沒(méi)過(guò)多久數(shù)據(jù)庫(kù)狀態(tài)和代碼預(yù)期就對(duì)不上了。SurrealDB團(tuán)隊(duì)官方推出的SurrealKit，正是為了解決這個(gè)Schema管理難題。

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

安裝很簡(jiǎn)單。用Rust的Cargo包管理器直接裝：cargo install surrealkit。不想編譯的話，GitHub releases頁(yè)面有預(yù)編譯二進(jìn)制文件。

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

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

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

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

sync模式適合本地?cái)?shù)據(jù)庫(kù)——你擁有完全控制權(quán)，刪改都沒(méi)關(guān)系。但推到共享環(huán)境時(shí)就得換思路了，rollouts模式能幫你做更可控的Schema遷移。這個(gè)工具把SurrealDB原本靈活的Schema管理，變成了可版本控制、可自動(dòng)化的工作流。