VS Code中pip安装dotenv报模块缺失及启动器错误如何修复

故障根因 #

你遇到的报错分两个独立问题：

1. 终端抛出的Fatal error in launcher是pip启动器的路径绑定失效：pip.exe启动时硬编码关联的Python解释器路径已经不存在（要么是你移动/删除过对应Python310安装目录，要么是重装Python后旧的pip残留文件没被清理，环境变量优先级错误），导致启动器找不到对应python.exe无法创建进程。
2. 你执行的pip install dotenv本身包名就是错误的，PyPI上的dotenv包是多年前停更的废弃包，日常开发用的环境变量读取包正确名称是python-dotenv，哪怕pip正常，装错包也会出现后续导入找不到模块的问题。

修复步骤 #

• 第一步：绕开损坏的pip启动器，用Python本体重建pip
  直接在VS Code终端执行以下命令，用当前终端默认加载的Python解释器升级并重建pip，自动修复路径绑定：

  python -m pip install --upgrade pip
  

• 第二步：校验Python路径有效性
  如果上一步执行仍然报错，执行以下命令查看终端识别到的Python路径列表：

  where python
  

  如果输出列表里存在报错提到的失效路径C:\Users\gwill\AppData\Local\Programs\Python\Python310\，且对应文件夹实际不存在，就打开系统环境变量设置，在用户变量、系统变量的Path条目中删除所有指向该失效目录的Python、Python\Scripts条目，再把你当前正常使用的Python安装目录、对应Scripts目录的路径加到Path优先级最靠前的位置，保存后重启VS Code终端重试。
  如果你电脑装了多个版本的Python，不要直接用pip命令调用，统一用版本指定的方式避免混淆，比如给Python3.10装包就用：

  py -3.10 -m pip install 包名
  

• 第三步：安装正确的dotenv包
  pip修复完成后，执行以下命令安装正确的包：

  pip install python-dotenv
  

  安装完成后执行pip list | findstr python-dotenv，能返回对应版本号即为安装成功，代码中通过from dotenv import load_dotenv即可正常调用。
• 额外校验：检查VS Code解释器配置
  看VS Code窗口右下角显示的Python解释器路径，确认选中的是你当前在用的有效Python环境，不要选中已经删除的虚拟环境、旧版本Python路径，切换解释器后重启终端再执行操作即可。

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