@azure/static-web-apps-cli

中文文档
2.1.0发布于 2026/10/20MITES Module近 30 天下载 63万

Azure 静态网络应用程序 CLI

中文使用文档
文档目录8 节
  1. Azure 静态网络应用程序 CLI
  2. 重要说明
  3. 快速启动
  4. 将 CLI 安装到 npm , (中文(简体) ), yarn 或者说 pnpm 数字 :
  5. 基本用途
  6. 扩展用途
  7. 使用 npx 数字 :
  8. 想帮忙吗?

Azure 静态网络应用程序 CLI

NPM version Node version CI status Contributions welcome

logo

Static Web Apps CLI,又名SWA CLI,是当地开发工具,用于: Azure 静态网络应用程序它可以:

  • 服务静态应用程序资产, 或代理到您的应用程序 dev 服务器
  • 服务 API 请求, 或代理到 Azure 函数核心工具运行的 APIs
  • 模拟认证和授权
  • 模拟静态网络应用程序配置,包括路由和ACL角色
  • 将您的应用应用到 Azure Static 网络应用

重要说明

如果您有建议或遇到问题,请报告或帮助我们解决。 非常感谢你的贡献

CLI模仿了Azure Static Web Apps云服务常用的能力. 预期会出现一些差异。 总是部署和测试你的应用 在Azure确认行为.

快速启动

将 CLI 安装到 npm, (中文(简体) ), yarn 或者说 pnpm数字 :

  • 要在您的工程中安装 CLI, 请使用 :

    npm install -D @azure/static-web-apps-cli
    

    您也可以在全球安装 SWA CLI npm install -g @azure/static-web-apps-cli。 。 。 .

基本用途

  • 在根部打开 SWA app文件夹( 在任何 / api 或/ app 文件夹外) :

    cd my-awesome-swa-app
    
  • 最好的开始方式是运行 swa 命令并跟踪交互式提示 :

    swa
    

它将为您生成一个配置, 然后构建您的项目, 并询问您是否想要将其部署到 Azure .

见 须花 更多细节.

扩展用途

以下是目前支持的 swa 命令。 使用 swa <command> --help 学习该特定命令的选择和使用.

  • login: 登录到 Azure 中
  • init: 初始化一个新的静态网络应用项目
  • start: 从目录启动仿真器或绑定到 dev 服务器
  • deploy: 将当前工程部署到 Azure Static Web Apps
  • build: 构建您的项目

使用 npx数字 :

  • 在根部打开 SWA app文件夹( 在任何 / api 或/ app 文件夹外) :
cd my-awesome-swa-app
  • 为您的工程创建配置 :
npx @azure/static-web-apps-cli init
  • 启动模拟器 :
npx @azure/static-web-apps-cli start
  • 访问您的 SWA 应用程序 http://localhost:4280

见所有可用的 命令和选项。 。 。 .

想帮忙吗?

想要归档错误, 提供一些代码, 还是改进文档 ? 不错! 阅读我们的准则 捐款 然后查一下我们清单上的问题之一: 社区帮助。 。 。 .

版本与发布记录

@azure/static-web-apps-cli 共发布 45 个版本,首次发布于 2021/02/17;过去 12 个月发布了 4 个版本。

版本发布日期距今
2.1.0latest2026/10/2018 天前
2.0.102026/07/203 个月前
2.0.92026/04/216 个月前
2.0.82026/02/039 个月前
2.0.72025/09/181.1 年前
2.0.62025/04/291.5 年前

关于 @azure/static-web-apps-cli 的常见问题

@azure/static-web-apps-cli 是什么?

Azure 静态网络应用程序 CLI

如何安装 @azure/static-web-apps-cli?

在项目目录运行 npm install @azure/static-web-apps-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 swa,可以用 npx swa 直接运行。

@azure/static-web-apps-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/azure__static-web-apps-cli 是否存在。

@azure/static-web-apps-cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@azure/static-web-apps-cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@azure/static-web-apps-cli 可以商用吗?

@azure/static-web-apps-cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@azure/static-web-apps-cli 的下载量有多少?

根据 npm 官方下载统计,@azure/static-web-apps-cli 在 2026/10/08 – 2026/11/06 这 30 天内被下载 629,696 次,日均约 20,990 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@azure/static-web-apps-cli 还在维护吗?

最新版本 2.1.0 发布于 2026/10/20(18 天前);至今共发布 45 个版本,其中过去 12 个月发布了 4 个;首次发布于 2021/02/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。