VSCode中用Python虚拟环境调用BeautifulSoup4遇ModuleNotFoundError

1. 确认pip与虚拟环境的绑定关系 #

激活虚拟环境后，执行以下命令验证pip归属：

pip --version

输出路径必须包含你的.venv文件夹（例如...\.venv\Scripts\pip.exe）。若显示全局pip路径，直接使用虚拟环境内的pip绝对路径重新安装：

.venv/Scripts/pip install beautifulsoup4

2. 锁定VSCode的运行解释器配置 #

• 打开VSCode「运行和调试」面板（Ctrl+Shift+D），创建launch.json文件并选择Python环境。
• 确保配置文件中指定的解释器路径指向虚拟环境：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: 当前文件",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "pythonPath": "${workspaceFolder}/.venv/Scripts/python.exe"
          }
      ]
  }
  

3. 验证库的安装位置 #

激活虚拟环境后，执行命令查看BeautifulSoup4的安装目录：

pip show beautifulsoup4

输出的Location必须指向.venv/Lib/site-packages。若路径不符，卸载后重新用虚拟环境内的pip安装：

pip uninstall -y beautifulsoup4
.venv/Scripts/pip install beautifulsoup4

4. 清理VSCode缓存并重启 #

完全关闭VSCode后重新打开，避免IDE缓存导致的识别异常。

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