已激活虚拟环境却仍出现ModuleNotFoundError的技术求助

问题描述 #

在Visual Studio中配置并激活了虚拟环境，此前运行一切正常，但现在所有导入的包均提示不存在。重新激活虚拟环境后问题依旧，且能看到虚拟环境中已安装对应包。

报错信息 #

Kweronda@DESKTOP-MT2OV1I MINGW64 ~/Desktop/tweetbot/src (master)
$ python tweek.py
Traceback (most recent call last):
  File "tweek.py", line 7, in <module>    
    import bs4
ModuleNotFoundError: No module named 'bs4'

代码导入片段 #

import random
import re
from turtle import delay
import dotenv
import requests
import bs4

# 创建quotes文件
import json as _json

# 创建tweet
import os
import time
import tweepy

项目文件结构说明 #

项目根目录包含src代码文件夹和venv虚拟环境文件夹，虚拟环境的Lib\site-packages目录下可见bs4、requests等已安装的包。

排查与解决步骤 #

• 确认当前Python解释器归属虚拟环境

  1. 激活虚拟环境后，执行where python（Windows）或which python（Linux/macOS），查看输出路径是否指向venv文件夹下的Python程序。
  2. 若输出为系统Python路径，说明激活命令未生效，需使用对应系统的激活命令：
     • Windows CMD：venv\Scripts\activate.bat
     • Windows PowerShell：venv\Scripts\Activate.ps1（需先允许脚本执行）
     • Linux/macOS：source venv/bin/activate
  3. 在VS Code中，可通过右下角的解释器选择栏，直接切换到虚拟环境对应的Python版本。

• 验证虚拟环境内的包是否真的存在
  激活虚拟环境后执行pip list，确认bs4、requests等依赖包在列表中。若缺失，重新安装：

  pip install bs4 requests python-dotenv tweepy
  

  若有requirements.txt文件，直接执行pip install -r requirements.txt。

• 清理Python缓存
  删除项目目录下的__pycache__文件夹，避免缓存导致模块识别异常，之后重新运行代码。

• 重建虚拟环境
  若以上步骤均无效，大概率是虚拟环境损坏。删除现有venv文件夹，重新创建并配置：

  # 创建新虚拟环境
  python -m venv venv
  # 激活虚拟环境（对应系统命令）
  # 安装所有依赖
  pip install bs4 requests python-dotenv tweepy
  

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