先确认哪个 Python 在运行

“终端里能导入，IDE 却报 ModuleNotFoundError”，不一定是包消失了，常见原因是终端和 IDE 调用了不同的 Python。先在实际运行程序的终端检查解释器与 pip：

python -c "import sys; print(sys.executable)"
python -m pip --version
python -m pip show requests

第一条给出当前解释器的完整路径；第二条能看出 pip 属于哪个 Python；第三条用于确认指定包是否安装在这个环境里。安装时优先写成 python -m pip install 包名，不要只敲 pip install。当电脑上同时有系统 Python、项目虚拟环境和 IDE 自带环境时，独立的 pip 可能指向另一套解释器。

给每个项目建立独立环境

在项目根目录创建一个虚拟环境，可以让项目依赖和系统环境分开。macOS/Linux 常见命令如下：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Windows PowerShell 可以这样做：

py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

如果 PowerShell 阻止激活脚本，不必为了一个项目直接放宽全局执行策略；可以用环境里的解释器完整路径运行，例如 .\.venv\Scripts\python.exe -m pip install -r requirements.txt。macOS/Linux 也可以用 .venv/bin/python -m pip install -r requirements.txt。激活脚本只是把虚拟环境的可执行目录放到当前终端的 PATH 前面，直接调用解释器同样有效。

让 IDE 选择同一个解释器

终端激活了 .venv，并不代表 IDE 的运行配置也自动切换。请在 IDE 的项目设置里选择项目目录下的解释器：macOS/Linux 通常是 .venv/bin/python，Windows 通常是 .venv\Scripts\python.exe。选择之后，重新运行程序或重启交互式内核，再执行前面的 sys.executable 检查；路径应该指向当前项目的 .venv。

如果路径一致但仍然报错，再检查三个细节：安装命令是否在激活虚拟环境后执行；运行配置是否指定了另一个启动解释器；包的安装名称和导入名称是否不同。比如安装包名和代码里的 import 名称并非总是一一相同，可以用 python -m pip show 包名 以及最小导入脚本进一步确认。

把可复现信息留在项目里

虚拟环境目录 .venv 通常不应提交到 Git。它包含本机路径和二进制文件，换目录或换电脑后不一定能继续使用。项目应保留 requirements.txt 或 pyproject.toml 等依赖清单，让新环境能够重新安装依赖。临时需要记录当前环境时，可以运行 python -m pip freeze > requirements.txt；维护长期项目时，最好区分直接依赖和间接依赖，并根据项目的锁定策略管理版本。

最后做一次最小验证：在 IDE 和终端分别运行 python -c "import sys; print(sys.executable)"，确认路径相同；再运行程序实际需要的导入测试。先核对解释器，再安装依赖，通常比反复全局安装更快，也更容易让同事复现。参考：Python 官方 venv 文档。