用途：帮助创建、配置和部署 Azure Static Web Apps（SWA）。SWA 用于托管静态前端，可选配无服务器 API 后端；SWA CLI（swa）提供本地开发模拟与部署能力。
主要能力：本地模拟器支持 API 代理与认证模拟；框架自动检测与配置；直接部署到 Azure；支持数据库连接。
配置文件：swa-cli.config.json 由 swa init 生成，切勿手动创建；staticwebapp.config.json 为运行时配置（路由、认证、标头、API 运行时），可手动创建。
安装与验证：npm install -D @azure/static-web-apps-cli；npx swa --version。
基本流程：先运行 swa init（必需，自动检测框架并生成配置），再 swa start 在 http://localhost:4280 启动本地模拟器，swa login 登录 Azure，swa deploy 部署。常用命令还包括 swa build、swa db init --database-type mssql|postgresql|cosmosdb_nosql。
适用场景：将静态站点部署到 Azure、搭建 SWA 本地开发环境、为前端添加 Azure Functions 后端、配置 GitHub Actions 部署。
限制与注意：必须先用 swa init 生成 swa-cli.config.json；本地 API 默认超时 45 秒；客户端路由 404 需在 staticwebapp.config.json 配置 navigationFallback；部署令牌过期需在 Azure 门户重新生成。支持的 API 运行时包括 node:18/20/22、dotnet:8.0、dotnet-isolated:8.0、python:3.10/3.11。