boundaries

实验性

边界通过检查包管理器工作区违规行为,确保 Turborepo 功能正常工作。

终端
turbo boundaries

边界 RFC

此功能为实验性功能,我们期待您对边界 RFC的反馈。

此命令将通知两种类型的违规行为

  • 导入包目录之外的文件
  • 导入未在包的 package.json 中指定为依赖项的包

标签

边界还具有一个功能,允许您向包添加标签。这些标签可用于创建边界检查规则。例如,您可以向您的 UI 包添加一个 internal 标签

Turborepo logo
./packages/ui/turbo.json
{
  "tags": ["internal"]
}

然后声明一个规则,具有 public 标签的包不能依赖于具有 internal 标签的包

Turborepo logo
./turbo.json
{
  "boundaries": {
    "tags": {
      "public": {
        "dependencies": {
          "deny": ["internal"]
        }
      }
    }
  }
}

或者,您可能希望 public 包仅依赖于其他 public

Turborepo logo
turbo.json
{
  "boundaries": {
    "tags": {
      "public": {
        "dependencies": {
          "allow": ["public"]
        }
      }
    }
  }
}

同样,您可以为标签的依赖项添加限制,即导入带有该标签的包的包。

Turborepo logo
turbo.json
{
  "boundaries": {
    "tags": {
      "private": {
        "dependents": {
          "deny": ["public"]
        }
      }
    }
  }
}

包名称也可以在允许和拒绝列表中代替标签使用。

Turborepo logo
turbo.json
{
  "boundaries": {
    "tags": {
      "private": {
        "dependents": {
          "deny": ["@repo/my-pkg"]
        }
      }
    }
  }
}

标签允许您确保错误的包不会在您的图中被导入。这些规则甚至适用于依赖项的依赖项,因此如果您导入一个包,而该包又导入另一个带有被拒绝标签的包,您仍然会收到规则违规。