你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
安装 Static Web Apps CLI (SWA CLI)
重要
为了提高通过静态 Web 应用 CLI 进行部署的安全性，我们引入了一项中断性变更，要求你在 2025 年 1 月 15 日前升级到静态 Web 应用 CLI 的最新版本 (2.0.2)。
可以使用不同的选项来安装 Azure Static Web Apps CLI。 Azure Static Web Apps CLI 要求在本地安装 Node.js。 默认情况下，Node.js 附带 Node 包管理器 (npm)，不过可以选择使用其他包管理器，例如 Yarn 或 pnpm。
| 资源 | 命令 |
|---|---|
npm |
npm install -g @azure/static-web-apps-cli |
yarn |
yarn add @azure/static-web-apps-cli |
pnpm |
pnpm install -g @azure/static-web-apps-cli |
注意
SWA CLI 仅支持节点版本 16 及更低版本。
验证安装
安装包使 swa 命令在计算机上可用。 可以通过请求 CLI 版本来验证安装是否成功。
swa --version
# When installed, the version number is printed out
使用情况
若要开始使用 CLI，可以单独运行 swa 命令，并按照交互式提示进行操作。
SWA CLI 交互式提示有助于指导你完成开发 Web 应用时不同的重要选项。
运行 swa 命令以开始设置应用程序。
swa
swa 命令将生成配置文件、生成项目，并提供部署到 Azure 的选项。
有关所有 SWA CLI 命令的详细信息，请参阅 CLI 参考。
使用 npx
可以使用 npx 直接运行任何 Static Web Apps CLI 命令。 例如：
npx @azure/static-web-apps-cli --version
或者，可以通过 start 命令启动模拟器：
npx @azure/static-web-apps-cli start