跳到主要内容

日常开发：跑脚本与本地调试

rabetbase 里和「在这个前端工程里跑命令」相关的，主要是 **run ：它不会去猜你要做什么业务，而是 读取当前目录的 package.json 里的 scripts **，用检测到的包管理器（bun / pnpm / yarn / npm）去执行。

列出当前项目能跑什么​

rabetbase run

不带参数时，会把 package.json 里所有 script 名列出来，方便你确认有没有 start、build、preview 等。

跑一个脚本​

rabetbase run start
rabetbase run build
rabetbase run test

名字和你项目里定义的一致即可。

对 start / dev 的特殊处理​

执行 start 或 dev 时，CLI 会 **先做版本检查 **（CLI 自身与项目里的 SDK），若有新版本会给出提示。这是为了减少「老版本脚手架 + 新平台行为」带来的奇怪问题。提示不等于失败，但若团队要求统一版本，建议按提示升级。

预览与 watch​

rabetbase run preview

若你的模板支持，可以加：

rabetbase run preview --watch

会按 CLI 内置逻辑并行启动构建监听与预览（具体行为以你项目 package.json 中 preview 脚本为准）。

与旧命令习惯对照​

以前有人习惯直接敲：

rabetbase start
rabetbase build

在 v2 里这些 **已废弃 **，会提示你改用：

rabetbase run start
rabetbase run build

记一条规则： **跑 npm 脚本一律加 run **，就不会和 rabetbase 自己的子命令（如 dataset、sql）混在一起。

小结​

  • rabetbase run = 当前项目的 package.json 脚本执行器。
  • start / dev 会带版本检查。
  • 旧的一键 rabetbase start 请改为 rabetbase run start。

接下来若要从平台拉 API 定义、查数据，读 API 与数据集：拉配置、看清数据。