用途:SpacetimeDB 命令行工具 spacetime 的参考,适用于初始化项目、构建模块、发布数据库、查询数据、管理服务器或排查 CLI 问题。
主要能力:spacetime init 初始化项目(--lang rust|csharp|typescript|cpp 或 --template);spacetime build 构建模块,--debug 加快迭代;spacetime dev 开发模式自动重建、自动发布并生成绑定;spacetime generate 生成客户端绑定(--lang typescript|csharp|rust,或 unrealcpp 配合 --uproject-dir、--unreal-module-name)。
发布与部署:spacetime publish 发布到默认 Maincloud 或 --server local,--yes 跳过确认,--delete-data=always 清空数据后重新发布。
数据交互:spacetime sql 执行 SQL(--interactive 进入 REPL);spacetime call 调用 reducer(每个参数为独立位置参数);spacetime subscribe 订阅变更;spacetime logs 查看日志(-f 跟随,-n 指定行数);spacetime describe 查看模式(--json 输出 JSON,可指定 tables、views、reducers、procedures、routes、env、types)。
数据库与服务器管理:spacetime list、delete、rename 管理数据库;spacetime server list/add/set-default/ping、spacetime start 管理服务器;spacetime login/logout/login show 处理认证。默认服务器为 maincloud(https://maincloud.spacetimedb.com)与 local(http://127.0.0.1:3000)。常用标志包括 --server/-s、--yes/-y、--anonymous、--module-path/-p、--no-config。
模块语言:服务端支持 Rust、C#、TypeScript、C++;客户端 SDK 为 TypeScript、C#、Rust、Unreal Engine;generate 目标为 TypeScript、C#、Rust、Unreal C++。
限制与排错:未登录需 spacetime login 或用 --anonymous;服务器无响应可用 server ping 检查,本地需确保 spacetime start 运行;模式冲突可加 --delete-data=always 重新发布;构建失败需检查 Rust/C# 工具链,Rust 模块需 wasm32-unknown-unknown 目标。