安装数据 API 生成器命令行接口

2025-06-11

在本指南中，你将完成在本地计算机上安装数据 API 生成器（DAB）命令行接口（CLI）的步骤。然后，您可以使用 CLI 执行 DAB 的最常见操作。 CLI 作为 .NET 工具分发。

先决条件

.NET 8

安装 CLI

将 NuGet 中的 Microsoft.DataApiBuilder 包安装为 .NET 工具。

使用dotnet tool install来安装带有--global参数的Microsoft.DataApiBuilder的最新版本。
```
dotnet tool install --global Microsoft.DataApiBuilder
```
注释

如果包已安装，请改用 dotnet tool update更新包。
```
dotnet tool update --global Microsoft.DataApiBuilder
```
请使用--global参数验证工具dotnet tool list是否已安装。
```
dotnet tool list --global
```

验证是否已安装 CLI

安装 .NET 工具可使 dab 命令在本地计算机上可用。

使用 --version 参数确定当前安装的版本。
```
dab --version
```
重要

如果在 Linux 或 macOS 上运行，则直接调用 dab 时可能会看到错误。若要解决此错误，请将 .NET 全局工具添加到你的 PATH。有关详细信息，请参阅数据 API 生成器安装故障排除。
观察上一命令的输出。假设 DAB CLI 的当前版本为 1.0.0，该命令将输出以下内容。
```
Microsoft.DataApiBuilder 1.0.0
```