添加
命令行
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