退出Python虚拟环境后系统仍查找pyvenv.cfg报错如何解决

问题原因 #

该报错的核心原因是系统当前调用的python.exe指向了未激活/已删除的虚拟环境内部的可执行文件，而非全局安装的Python可执行文件。虚拟环境中的python.exe启动时会优先读取同目录下的pyvenv.cfg配置文件，找不到就会抛出该错误。

解决步骤 #

• 第一步：定位当前python指向的路径
  在终端执行如下命令：
  where python
  执行后会按系统优先级输出所有匹配的python.exe路径，排在第一位的路径大概率属于某一个虚拟环境的Scripts目录，而非全局Python的安装路径（正常全局路径格式为C:\Program Files\PythonXX\python.exe或C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX\python.exe）。
• 第二步：修正系统Path环境变量
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 分别在「用户变量」和「系统变量」板块找到Path变量，双击进入编辑页
  3. 找到列表中对应虚拟环境的路径（格式类似D:\项目目录\venv\Scripts），将其删除
  4. 确认全局Python的安装路径、对应Scripts路径已经在Path列表中，如不存在可手动添加。如果需要全局Python优先生效，将这两个路径上移到所有其他Python相关路径的顶部
• 第三步：排查PowerShell别名配置
  如果你使用PowerShell终端，可执行如下命令检查是否配置了指向虚拟环境的python别名：
  Get-Alias python
  如果输出结果指向虚拟环境路径，可打开PowerShell配置文件$PROFILE，删除里面关于python别名的配置行即可。
• 第四步：验证修复结果
  所有配置修改完成后重启终端，执行python --version，若正常返回全局Python版本号即修复完成。

内容的提问来源于stack exchange，提问作者K.W. LEE