如何配置PyCharm终端支持Azure CLI发布Azure Functions？

故障表现 #

完成Azure CLI Windows端安装后，系统自带PowerShell、CMD环境下可正常执行az相关命令，也可正常运行func azure functionapp publish MyAppName完成函数发布；但在PyCharm内置终端执行相同发布命令时返回如下错误：

Unable to connect to Azure. Make sure you have the az CLI or Az.Accounts PowerShell module installed and logged in and try again

解决步骤 #

按以下顺序逐一排查即可：

• 完全重启PyCharm
  安装Azure CLI时会向系统PATH新增az命令的执行路径（默认路径为C:\Program Files\Microsoft SDKs\Azure\CLI2\wbin），如果安装Azure CLI时PyCharm处于运行状态，PyCharm不会自动同步最新的系统环境变量，会导致内置终端找不到az命令。彻底关闭所有PyCharm进程后重新启动，先在终端执行az version，如果能正常返回CLI版本信息，重新执行发布命令即可。
• 手动补全PyCharm终端的环境变量
  如果重启后仍无法识别az命令，在PyCharm内置终端执行对应命令查看当前PATH配置：
  • 若终端为PowerShell，执行echo $env:PATH
  • 若终端为CMD，执行echo %PATH%
    检查输出结果中是否包含上述Azure CLI默认安装路径，如果缺失，打开PyCharm设置→工具→终端，找到环境变量配置项，将Azure CLI的wbin目录路径追加到PATH变量值末尾，保存后重启终端重试。
• 重新完成Azure账号登录校验
  环境变量识别正常后，先在PyCharm终端执行az login完成账号登录。注意如果启动PyCharm时使用的权限（普通用户/管理员）和之前在系统PowerShell/CMD中登录az时的权限不一致，两边的登录态不互通，必须在当前PyCharm终端环境下重新登录。
• 修正终端Shell配置
  如果PyCharm默认配置的内置终端是Git Bash、WSL等非Windows原生Shell，会存在无法识别Windows侧安装的Azure CLI的问题。可以在PyCharm终端设置页，将默认Shell路径修改为系统原生PowerShell（对应路径C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe）或CMD（对应路径C:\Windows\System32\cmd.exe），保存后重启终端再重试。

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