已安装Azure CLI仍被提示未安装，SSO Office Add-in配置失败

问题现象 #

配置带单点登录（SSO）的Office Add-in时，已安装Azure CLI 2.53.0且az --version能正常输出完整版本信息，但执行npm run configure-sso时仍重复触发Azure CLI安装流程，重装工具后问题依旧。

解决步骤 #

• 检查系统PATH环境变量
  Azure CLI的可执行文件实际位于C:\Program Files\Microsoft SDKs\Azure\CLI2\wbin目录，需确认该路径已添加到系统变量的PATH中：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」区域找到PATH，检查是否包含上述路径，若缺失则添加
  3. 重启所有打开的终端（包括VS Code终端），确保环境变量生效

• 验证全局az命令可用性
  打开新的命令提示符/PowerShell，直接输入az，确认命令能正常响应（无需切换到Azure CLI安装目录）。若能正常运行，再执行npm run configure-sso。

• 修复Azure CLI安装状态
  以管理员身份打开命令提示符，执行以下命令：

  az self-update
  

  该命令会强制更新CLI并修复可能的安装损坏。之后执行az login完成一次Azure登录，确保CLI能正常与Azure通信，再尝试SSO配置。

• 切换终端环境执行脚本
  部分npm脚本可能依赖特定shell（如Git Bash）的PATH配置存在问题，尝试在原生命令提示符或PowerShell中执行npm run configure-sso，而非第三方终端。

• 检查SSO配置脚本的检查逻辑
  打开项目的package.json，找到configure-sso对应的脚本内容，确认它检测Azure CLI的方式：

  • 若脚本通过注册表项检查，可手动验证注册表中HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure CLI路径是否存在且版本信息正确
  • 若脚本通过特定路径检查，确保该路径与实际安装路径一致

内容的提问来源于stack exchange，提问作者tony