vscode 管理 azure 资源的前提是正确登录 azure account 并选定目标订阅，否则所有操作静默失败；扩展依赖身份上下文，需检查右下角订阅显示、启用必要插件、配置启动文件、确保函数路由匹配及远程调试设置正确。
VSCode 要真正管得了 Azure 资源、能本地调试还能一键部署，不是装几个插件就完事——关键在于 Azure Account 必须先登录并确认右下角显示的是目标订阅，否则所有后续操作（部署、函数调试、资源启停）都会静默失败或落到错误租户里。
为什么 Azure Resources 树状列表为空或右键没反应
这不是网络问题，而是身份上下文没建立。VSCode 的所有 Azure 扩展（Azure Functions、Azure App Service、Azure Resources）都依赖 Azure Account 提供的 token 和订阅上下文。它不光是登录入口，更是权限透传中枢。
- 检查左下角状态栏是否显示类似
user@domain.com (MyProductionSub)——只显示Not signed in或邮箱但没括号内订阅名，说明登录未完成或未选订阅 - 按
Ctrl+Shift+P输入Azure: Select Subscriptions，手动勾选目标订阅（尤其当账号绑定多个租户时） - 安装
Azure Account后必须重启 VSCode 或执行Developer: Reload Window，否则命令不注册、图标不出现 - 企业环境启用 Conditional Access 时，浏览器授权页可能卡住；建议手动复制设备码到
https://microsoft.com/devicelogin完成验证
部署 Web 应用时 “Deploy to Web App…” 命令找不到
这是典型插件组合缺失：仅装 Azure App Service 不够，Azure Account 必须已启用且登录成功。VSCode 不会报错提示缺依赖，而是直接让命令不可见。
- 确保已安装并启用两个扩展：
Azure Account（身份）、Azure App Service（部署能力） - 项目根目录必须含有效启动文件：
package.json（Node.js）、requirements.txt（Python）、.csproj（.NET），否则向导中途退出 - 部署前右键项目文件夹，若菜单中无
Deploy to Web App…，打开命令面板搜azureAppService.Deploy——报command not found就是插件没生效 - Mac 用户注意：若用
brew install azure-cli安装 CLI，需确保 VSCode 终端能识别az命令（检查PATH是否包含/opt/homebrew/bin）
函数本地调试正常，部署后 HTTP 触发器返回 404
不是代码没上传，而是路由映射或函数标识不一致。Azure Functions 的 URL 是严格拼接的：https://{app-name}.azurewebsites.net/api/{function-name}，其中 {function-name} 必须与代码中声明的完全匹配（大小写敏感、无空格）。
- 检查函数类顶部的
[FunctionName("MyHttpFunc")]属性值，部署后访问路径必须是/api/MyHttpFunc，不能是/api/myhttpfunc - 若显式配置了
function.json中的route字段（如"route": "test"），则实际路径为/api/test，和函数名无关 - 函数名含空格或大写字母（如
My Function）会被 URL 编码为My%20Function，但运行时不识别，应改用短横线格式（my-function） - 检查函数应用是否启用了
Always On（免费层默认关闭），冷启动可能导致首次请求超时被网关拦截，看似 404
远程调试函数或 AKS Pod 时断点不命中
本地调试和远程调试底层机制不同：远程调试依赖函数应用开启调试端口、网络策略放行、以及 VSCode 正确附加到运行中的进程。断点不触发，往往卡在连接环节而非代码逻辑。
- 函数应用必须启用
Remote Debugging（在 Portal → Function App → Configuration → General settings 中开启），且运行时栈支持（Linux Consumption 不支持） - AKS 场景下，
Port Forward需确保 Pod 处于Running状态，且容器监听的端口（如5000）与本地映射端口一致 - Python 函数远程调试需额外配置：
launch.json中添加"justMyCode": false，否则断点只在用户代码生效，跳过框架层 - 调试前先在 VSCode OUTPUT 面板切换到
Azure Functions标签，查看是否输出Attaching to process...——无此日志说明未成功建立调试通道
最容易被忽略的其实是订阅上下文的“可见性”：右下角那个小小的订阅名，不是装饰，而是所有资源创建、部署、调试的默认作用域。它不报错，但一旦选错，你建的 VM 在测试环境，部署的函数在开发订阅，连调试的 Pod 都连不到目标集群——所有操作都对，结果全错。
