Azure Static Web Apps插件仅支持静态网站部署，要求项目含合法staticwebapp.config.json、构建输出路径真实存在且非空，且必须通过az login完成CLI认证并指定Enabled状态订阅。
VSCode 用 Azure 插件发布网站，关键不在“能不能”，而在于「哪类网站走哪条路」——静态站、Web 应用、函数、容器，对应完全不同的插件和流程，混用必失败。
Azure Static Web Apps 插件只认静态站点
它不处理后端逻辑，也不部署 package.json 启动的服务。如果你的项目含 Express、Flask 或 .NET Core 启动文件，这个插件会静默跳过构建或报错 Failed to detect framework。
- 必须确保项目根目录有合法
staticwebapp.config.json（哪怕只是空对象{}） - 构建输出路径（如
/dist、/public）需真实存在且非空；插件不会自动运行npm run build - 若部署卡在“Select app”但列表为空，大概率是
az account set没指定启用状态为Enabled的订阅
Azure App Service 插件要求明确的启动标识
它靠识别项目中的框架元数据来决定部署方式：Node.js 看 package.json 里是否有 scripts.start，Python 看 requirements.txt，.NET 看 .csproj。缺一个，就可能 fallback 到纯 ZIP 部署，导致运行时找不到入口。
- Node.js 项目务必定义
"start": "node server.js"或类似命令，不能只写"dev": "nodemon..." - Python 项目若用 FastAPI/Flask，需在根目录放
gunicorn.conf.py或startup.txt显式指定启动模块，否则默认用manage.py runserver - 部署前手动在 VSCode 集成终端执行一次
az webapp up --location <code>region--namemyapp，可快速验证资源组、应用服务计划是否就绪
Azure CLI 是所有插件的底层依赖，不是可选项
VSCode 的 Azure 插件（Account / App Service / Static Web Apps）全部复用本地 az 的登录态和权限。你在终端里 az login 失败，插件里的“Sign In”按钮就会一直转圈或弹出空白浏览器窗口。
- macOS 上用
brew install azure-cli安装后，必须运行az login并完成设备码认证，不能只靠插件内点击登录 -
az account list --output table输出里 Subscription 状态必须是Enabled，灰色的Disabled或Expired订阅插件根本看不到 - 插件界面选错区域（比如选了
East US，但你的资源组在West Europe），部署会卡在“Creating resource group”，实际是权限+区域双重校验失败
最容易被忽略的是：Azure Static Web Apps 和 Azure App Service 插件虽然都叫“Azure”，但背后是两套完全隔离的资源模型与 API。你用 Static Web Apps 插件部署了一个站点，它不会出现在 App Service 的资源列表里，反之亦然——别指望在一个插件里管理所有已部署网站。
