PyCharm终端已安装firebase-admin但项目解释器无法识别且安装报错

这是PyCharm项目解释器与系统全局Python环境不匹配导致的。你在系统终端执行pip install firebase-admin时，包被安装到了系统全局Python 3.10的site-packages目录，但当前PyCharm项目默认使用独立的虚拟环境或其他路径的Python解释器，无法读取全局环境下安装的包，因此在包列表中看不到firebase-admin；通过PyCharm内置包管理安装报错，基本都是虚拟环境路径错配、pip源访问失败或权限不足导致的。

按优先级依次尝试以下操作：

• 切换项目解释器为已装包的全局Python
  打开设置 > Project: 你的项目名称 > Python Interpreter，点击解释器选择框右侧的齿轮图标，选择Add Interpreter > System Interpreter，在文件选择框中选中路径c:\users\xubil\appdata\local\programs\python\python310\python.exe，保存后等待PyCharm完成索引重建，已安装包列表中就会显示firebase-admin，项目中也可以正常导入使用。
• 为当前项目的虚拟环境单独安装firebase-admin
  如果需要保留项目虚拟环境的隔离性，不要用外部系统终端执行安装命令，直接打开PyCharm底部的Terminal面板（该面板会自动激活当前项目的虚拟环境），在面板中执行安装命令：

  pip install firebase-admin
  

  安装完成后刷新包列表即可正常识别。
• 安装报错的针对性排查
  • 执行pip --version确认当前终端调用的pip属于当前项目虚拟环境，而非全局Python的pip，避免路径错配
  • 如果出现下载超时、连接失败的报错，换国内镜像源安装：

    pip install firebase-admin -i https://pypi.tuna.tsinghua.edu.cn/simple
    

  • 如果出现权限类报错，关闭PyCharm后右键选择「以管理员身份运行」，再重新执行安装操作。

内容的提问来源于stack exchange，提问作者Bill.xby