vscode连接azure云服务关键在于登录后确认右下角显示目标订阅，否则部署将误入错误租户；必须安装并登录azure account扩展，它是所有azure功能的身份入口，未生效时右下角仅显示“not signed in”。
VSCode 连接 Azure 云服务不是“连上就行”，关键在登录后确认右下角显示的是目标订阅——否则所有部署操作都可能落到错误租户或测试环境里。
Azure Account 扩展没装或没登录，后续所有操作都会静默失败
VSCode 的 Azure 功能全部依赖 Azure Account 扩展作为身份入口。它不光是登录按钮，还负责把 token 透传给 Azure Functions、Azure App Service 等其他扩展。没装或登录中断时，左侧不会出现云朵图标，右键菜单里也找不到 Deploy to Web App 这类命令。
- 安装后必须重启 VSCode 或点击“重新加载”按钮，否则命令面板里搜不到
Azure: Sign In - 登录成功后，右下角状态栏会显示订阅名（如
MyProductionSub (xxx-xxx-xxx)），点它可切换；如果只显示“Not signed in”，说明凭证未生效 - 不要用浏览器保存的 Microsoft 账号自动填充——有时会卡在组织账号授权页，建议手动复制设备码到 https://www.php.cn/link/1cc7c66acd638596b303e700788afe91
部署 Web 应用时选错运行时栈或 SKU，会导致启动失败或费用激增
VSCode 的 Azure App Service 扩展在部署向导中会引导你选“运行时栈”（Runtime Stack）和“应用服务计划”（App Service Plan）。这两个选项直接影响底层容器镜像、可用 API 版本，甚至计费模型。
- Node.js 项目若选了
Node 18 LTS但代码用了Node 20的fetch全局方法，部署后会报ReferenceError: fetch is not defined - 选
Free或SharedSKU 无法启用 HTTPS 自定义域名，且冷启动延迟明显；生产环境至少选B1或更高 - Linux 和 Windows 实例不兼容：Windows 上跑 .NET Framework 项目，Linux 上只能跑 .NET Core / .NET 6+；混选会导致
Failed to start worker process
函数本地调试正常，但部署后 HTTP 触发器 404，大概率是授权级别或路由配置不对
用 Azure Functions 扩展创建的 HTTP 函数，默认授权级别设为 Anonymous，但部署后仍返回 404，常见于路径映射或函数名冲突。
- 函数名不能含空格或大写字母（如
My Function），部署时会被转成my%20function，但实际路由只认小写加短横线格式（my-function） - 检查
function.json中的route字段：留空时默认为函数名；若显式写了"route": "api/test"，访问地址就不是/api/{functionName}而是/api/test - 部署目标必须是已启用
HTTP触发支持的函数应用——旧版 Consumption Plan 默认关掉该功能，需进 Portal 手动开启或换用 Flex Consumption
右键部署失败但没报错，先看输出窗口里的 azure-cli 日志
VSCode 的 Azure 扩展底层调用的是本地 az CLI，所有操作都通过 az webapp up、az functionapp deployment source config-zip 等命令执行。图形界面隐藏了细节，但错误全在输出窗口（Output → Azure）里。
- 打开输出窗口后，从下拉菜单选
Azure或Azure App Service，不要只看弹窗提示 - 常见线索：
ResourceGroupNotFound表示资源组不存在且未勾选“新建”；LocationNotAvailableForSubscription是区域不支持该 SKU；CannotAccessKeyVault多因函数应用没被赋予 Key Vault Reader 权限 - 如果日志里反复出现
Authentication failed，不是密码错了，而是 Azure Account 扩展的 token 过期了——退出重登比重启 VSCode 更有效
最易被忽略的一点：VSCode 部署过程不会校验 package.json 或 requirements.txt 里的依赖是否与目标运行时兼容。比如 Python 项目用了 asyncio.to_thread（3.9+），却部署到 Azure 默认的 3.8 运行时，函数启动就会直接崩溃，而错误只出现在函数实例的日志里，不在部署流中体现。
