Azure插件常见问题根因是环境配置冲突：登录失败多因浏览器策略/代理拦截，部署报错常因订阅未切换或资源组路径不匹配，Python调试断点失效源于worker未就绪或launch.json端口不一致，SWA预览失败主因构建路径与路由配置未对齐。
安装 Azure Account 插件后无法登录
这是最常见问题：插件装了，但点击“Sign in to Azure”没反应，或弹出空白窗口。根本原因通常是 VSCode 内置浏览器被系统策略或代理拦截，或本地 msedge / chrome 默认浏览器未正确注册。
- 先尝试在终端运行
code --disable-gpu --no-sandbox启动 VSCode，再试登录——绕过部分图形渲染层干扰 - 确保系统已安装 Microsoft Edge（Chromium 版）或 Chrome，并在系统设置中设为默认浏览器；VSCode 的 Azure 登录依赖其 WebView 使用系统默认浏览器协议处理重定向
- 若公司网络启用代理，需在 VSCode 设置中显式配置：
http.proxy和http.proxyStrictSSL: false（仅限可信内网环境），否则 OAuth 流程卡在回调地址验证 - 登录失败时注意看输出面板 → “Azure Account” 频道，真实错误常是
ERR_CONNECTION_REFUSED或login.microsoftonline.com refused to connect，而非界面提示的“network error”
部署 Function App 时提示“Resource group does not exist”
即使你在 Azure Portal 看到资源组存在，VSCode 插件仍报错，大概率是订阅上下文未切换正确，或资源组位于不同区域/订阅中。
- 在 VSCode 左下角状态栏点击 Azure 账户图标 → “Select Subscription”，确认当前选中的是目标资源组所在订阅（一个账号可绑定多个订阅）
- 执行部署前，务必右键项目根目录 → “Deploy to Function App…” → 在弹出的资源选择流程中，手动展开“Resource Group”下拉项，不要依赖默认值；首次加载可能缓存旧列表，可按
Ctrl+Shift+P→ 输入Azure: Refresh强制同步 - 注意区分大小写和连字符：资源组名
my-rg-prod和My-RG-Prod在 API 层被视为不同资源，Portal 显示正常不代表插件能匹配 - 如果资源组确实在目标订阅中，但插件列表为空，检查是否启用了 Resource Graph 扩展冲突，临时禁用它再试
调试 Python Function 时断点不命中
Python 函数本地调试启动成功、日志也输出，但所有断点灰色不可达，本质是 VSCode 没把调试器 attach 到正确的进程，或函数入口路径未被识别。
- 确认
local.settings.json中Values.AzureWebJobsStorage值为UseDevelopmentStorage=true（非空字符串），否则 Functions Core Tools 会跳过本地存储初始化，导致 host 启动异常静默 - 在函数项目根目录下必须存在
__init__.py且含有效main()入口；VSCode 的 Python 调试器依赖此结构推导 module path，缺失会导致ModuleNotFoundError静默吞掉错误 - 启动调试前，先在终端运行
func start --verbose，观察输出中是否有Worker process started and initialized；若无，说明 Python worker 未就绪，此时 VSCode 调试器 attach 失败 - 调试配置
.vscode/launch.json中，type必须为python，request为attach，且port与func启动时打印的Debugger listening on ws://127.0.0.1:9229一致（默认 9229）
使用 Azure Static Web Apps 插件预览失败
点击“SWA: Preview Site”后浏览器打开空白页或 404，不是代码问题，而是构建产物路径未对齐插件预期。
- 插件默认从
dist目录托管静态文件，但 Vue/React 项目常输出到dist/my-app或build；需在项目根目录创建staticwebapp.config.json，显式指定"output_location": "dist"或对应路径 - 若前端框架启用路由 history 模式（如 Vue Router 的
mode: 'history'），必须在staticwebapp.config.json中添加"routes"重写规则，否则刷新页面返回 404 - 预览服务监听
http://localhost:4280，若该端口被占用（如 Docker Desktop 占用），插件不会报错，只会静默失败；可先执行lsof -i :4280（macOS/Linux）或netstat -ano | findstr :4280（Windows）查杀冲突进程 - 插件生成的预览链接带临时 token，有效期约 1 小时；关闭 VSCode 后再次打开，需重新点击预览，不能复用旧链接
