vscode 通过插件调用 azure cli 实现部署，失败时需先验证 az login 和订阅状态，确保 staticwebapp.config.json 存在于根目录且 json 合法，优先使用命令面板而非右键触发部署。
VSCode 本身不直接执行部署，但通过插件可以串联本地开发、构建、登录云平台、上传资源等环节。真正起作用的是插件背后调用的 CLI 工具和配置文件，不是图形界面点几下就能完事。
Azure Static Web Apps 插件部署失败时，先确认 az login 是否生效
这个插件本质是调用 Azure CLI，不是独立服务。如果 az login 没成功，或者当前默认订阅不是你期望的那个，插件连“选哪个资源组”这一步都卡住。
- 终端里运行
az account list --output table，检查输出里有没有状态为Enabled的订阅 - 若看到多个订阅，用
az account set --subscription "your-subscription-name"显式指定，别依赖插件自动选 - 插件里点击登录按钮后没反应？直接关掉插件面板，回终端跑一遍
az login再重试
staticwebapp.config.json 文件缺失或格式错误会导致部署被 Azure 拒绝
这个文件不是可选的——哪怕你只做纯静态页面，Azure 也会在部署前校验它是否存在且 JSON 合法。报错信息通常是 Failed to parse staticwebapp.config.json 或更模糊的 Invalid configuration，实际就是语法或路径问题。
- 必须放在项目根目录，不能在
src/或dist/下 - 最简合法内容只要一个空对象：
{}；有路由重写需求再加routes字段 - VSCode 右键该文件 → “Validate JSON Schema” 能快速发现逗号遗漏、引号不配对这类低级错误
绕过 UI 点击，用命令面板触发部署更可靠
插件图标点击有时会因上下文丢失或状态未刷新而无响应，尤其在刚装完插件或切换项目后。命令面板调用是插件注册的原始入口，跳过了所有中间渲染逻辑。
- 快捷键
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Win/Linux）打开命令面板 - 输入
Azure Static Web Apps: Deploy to Static Web App，回车 - 后续选择订阅、资源组、应用名称时，如果某步卡住，就回到终端确认
az account list输出是否仍有效
部署流程里最容易被忽略的，是插件和 CLI 的权限边界：插件只是个“遥控器”，真正干活的是你本机装的 Azure CLI 和它持有的 token。任何一步失败，优先查 CLI 状态，而不是反复重装插件。
