跳转到正文

添加

命令行
npx blockstudio add <blocks...> [options]

从注册表下载区块,并将其写入项目的区块目录。

参数

参数 说明
blocks 一个或多个要添加的区块。格式:namespace/block,或仅使用 block。

选项

选项 说明
-y, --yes 跳过所有提示(覆盖、冲突解决)。
--dry-run 预览将要安装的内容,不写入文件。

命名空间解析

指定命名空间时,CLI 会在该特定注册表中查找:

命令行
npx blockstudio add ui/tabs

省略命名空间时,CLI 会搜索所有已配置的注册表:

命令行
npx blockstudio add tabs

如果区块只在一个注册表中找到,则自动使用。如果在多个注册表中找到,CLI 会显示交互式选择提示供你选择。

使用 --yes 时,会采用 blocks.json 顺序中第一个匹配的注册表。 如果没有终端且使用了 --dry-run,遇到不明确的名称时,命令会停止并报错,同时列出注册表:

代码
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

解析任何区块之前,add 会获取所有已配置的注册表。如果其中一个无法访问或无效,命令就会失败,即使区块指定了明确的命名空间也一样。

依赖项

区块可以声明对同一注册表中其他区块的依赖。添加区块时,会自动解析并安装其依赖项。

命令行
npx blockstudio add ui/tabs

如果 tabs 依赖于 tab-item,这两个区块都会被下载并安装。依赖项始终先于依赖它们的区块安装。

检测到循环依赖时会报错并拒绝操作。

覆盖行为

如果目标目录中已存在区块文件夹:

  • 交互模式:提示你确认覆盖
  • --yes 标志:不询问,直接覆盖
  • --dry-run 标志:报告将要覆盖的内容
  • 未使用 --yes 的非交互模式:在下载前停止,并显示 Block "<name>" already exists at <path>. Use --yes to overwrite.

检查也会涵盖依赖项,因此如果 tab-item 已安装,添加 tabs 需要使用 --yes。

多个区块

同一命令中传入的区块会按顺序处理。如果其中一个失败,命令会在此处停止;本次运行中更早安装的区块会保留在磁盘上。

示例

添加单个区块:

命令行
npx blockstudio add ui/hero

添加多个区块:

命令行
npx blockstudio add ui/tabs ui/hero ui/accordion

预览但不写入:

命令行
npx blockstudio add ui/tabs --dry-run

跳过所有提示:

命令行
npx blockstudio add ui/tabs --yes