确认 Azure Toolkit 已正确安装：打开 Settings/Preferences（Ctrl+Alt+S），进入 Plugins 页面，在 Marketplace 搜索“Azure Toolkit for IntelliJ”，若显示已安装且状态为 Enabled，则插件就位；否则需安装并重启 IDE。
IntelliJ IDEA 本身不直接“配置 Azure 云服务”，而是通过 Azure Toolkit for IntelliJ 插件连接并操作 Azure 资源。没装插件、没登录账户、没选对订阅，后续所有操作（部署函数、Web 应用、VM、OpenAI）都会卡在第一步。
怎么确认 Azure Toolkit 已正确安装
打开 Settings/Preferences（Ctrl+Alt+S），进入 Plugins 页面，在 Marketplace 搜索栏输入 Azure Toolkit for IntelliJ。如果显示已安装且状态为 “Enabled”，说明插件就位；若未出现或显示 “Install”，需手动安装——注意必须重启 IDE 才生效。Community 和 Ultimate 版本都支持，但某些高级功能（如远程文件系统）仅限 Ultimate。
- 安装后不重启 →
Azure Explorer工具窗口不会出现在侧边栏 - 插件版本过旧（比如低于 v2026.1）→ 可能无法识别新版 Azure CLI 或 OAuth 流程变更
- 同时装了多个 Azure 相关插件（如旧版
Azure Tools）→ 会冲突，导致登录按钮失效或反复弹窗
登录失败常见原因和绕过方法
点击 Azure 登入 图标后卡在空白窗口、报错 Failed to launch browser 或提示 No default browser found，大概率是认证方式与本地环境不匹配。OAuth 2.0 依赖系统默认浏览器，而某些企业环境禁用了外部调用；Azure CLI 登录则要求本地已执行过 az login 并成功返回 token。
- 用
Azure CLI登录前，先终端运行az version确认 CLI 已安装，再运行az login完成一次完整登录 - 用
Device code登录时，务必在弹出的对话框里点複製與開啟（不是手动复制代码再粘贴），否则浏览器可能跳转到错误页面 - 如果公司网络屏蔽了 Microsoft 登录域名，OAuth 会超时；此时只能切回 Device code 或提前配置好代理（IDEA 的
Settings > Appearance & Behavior > System Settings > HTTP Proxy）
订阅选错会导致资源创建失败
登录后弹出的 選取訂用帳戶 对话框不是可选项，而是强制选择项。选错订阅，后续所有部署操作（比如右键项目 → Deploy to Azure Web App）会静默失败，控制台只输出 Resource group not found 或 Permission denied，根本不会提示“你选错了订阅”。
- 一个 Azure 账户下可能有多个订阅（如
Pay-As-You-Go、Visual Studio Enterprise、Free Trial），免费试用订阅通常有额度限制，部署 VM 或 App Service 可能被拒 - 某些资源（如 Azure OpenAI）需在特定订阅中手动申请配额，即使登录成功，选错订阅也无法看到
Azure OpenAI节点 - IDEA 不会记住上次选择 —— 每次重启或重装插件后都要重新选，建议把目标订阅名称记下来，避免手误
连接 Azure 存储或大数据服务要额外填参数
仅登录账户 ≠ 能访问所有 Azure 服务。比如要挂载 Blob Storage，需在 Big Data Tools 窗口里新建连接，并手动填 Connection string 或 SAS token。OAuth 登录只提供账户级权限，不自动下发存储访问密钥。
-
Connection string必须从 Azure Portal 的存储账户 →Access keys页面复制，不能用门户上显示的“示例连接字符串”模板 - 用
SAS token时，务必勾选Enable connection，否则即使测试成功，实际展开容器列表仍为空 - 填写
Container字段时，若想列出所有容器，必须选All containers in the account；选Custom roots后留空或填错名称，Explorer 中将不显示任何内容
真正麻烦的不是登录动作本身，而是登录后 IDE 没有明确反馈哪些资源可用、哪些权限缺失、哪些配置项被忽略。很多问题表面是“部署失败”，根因其实是订阅选错、存储连接未启用、或插件版本与当前 Azure API 不兼容——这些细节不会主动提醒，得靠日志里那行不起眼的 403 Forbidden 或 ResourceNotFound 倒推回去查。
