Python项目模块丢失，pip安装遇外部管理环境错误求助

昨天还在正常开发的Django项目，今天打开后提示找不到两个模块，此前一切正常。尝试用pip安装时系统提示Requirement already satisfied，缺失的模块对应导入语句：

from decouple import config
from celery.schedules import crontab

执行pip3 install decouple时触发以下错误：

just@4G05D8DPAA4A78D hockeyvoorspeller % pip3 install decouple
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try brew install
    xyz, where xyz is the package you are trying to
    install.

If you wish to install a Python library that isn't in Homebrew,
use a virtual environment:

python3 -m venv path/to/venv
source path/to/venv/bin/activate
python3 -m pip install xyz

If you wish to install a Python application that isn't in Homebrew,
it may be easiest to use 'pipx install xyz', which will manage a
virtual environment for you. You can install pipx with

brew install pipx

You may restore the old behavior of pip by passing
the '--break-system-packages' flag to pip, or by adding
'break-system-packages = true' to your pip.conf file. The latter
will permanently disable this error.

If you disable this error, we STRONGLY recommend that you additionally
pass the '--user' flag to pip, or set 'user = true' in your pip.conf
file. Failure to do this can result in a broken Homebrew installation.

Read more about this behavior here: <https://peps.python.org/pep-0668/>

note: If you believe this is a mistake, please contact your 
Python installation or OS distribution provider. You can override 
this, at the risk of breaking your Python installation or OS, by 
passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

[notice] A new release of pip is available: 24.0 -> 24.2
[notice] To update, run: python3.12 -m pip install --upgrade pip

核心原因 #

你的系统启用了PEP 668规范，禁止直接全局安装Python包以避免破坏系统依赖；同时你大概率之前用了虚拟环境开发，今天打开项目时未激活，导致找不到已安装的包。

步骤1：激活项目虚拟环境 #

Python开发必须用虚拟环境，找到你项目里的虚拟环境目录（通常是venv或env），进入项目目录后执行：

source venv/bin/activate

激活后命令行开头会显示(venv)，说明已进入正确环境。

步骤2：安装正确的包 #

注意：decouple对应的PyPI包是python-decouple，直接装decouple会安装错误的包。在激活的虚拟环境中执行：

pip install python-decouple celery

步骤3：验证安装 #

执行以下命令测试是否能正常导入：

python -c "from decouple import config; from celery.schedules import crontab; print('导入成功')"

如果输出导入成功，说明问题解决，直接运行项目即可。

备选方案（不推荐） #

如果暂时不想用虚拟环境，可强制安装（可能破坏系统环境）：

pip3 install python-decouple celery --break-system-packages

内容的提问来源于stack exchange，提问作者Just Verhagen