MacOS下如何用pip3全局安装matplotlib并绕过外部管理环境错误？

当执行pip3 install matplotlib尝试全局安装Python包时，触发externally-managed-environment错误，错误信息如下：

error: externally-managed-environment

× This environment is externally managed
╰─> 若要全局安装Python包，请尝试使用brew install xyz，其中xyz为你要安装的包。

若你想安装Homebrew中没有的Python库，请使用虚拟环境：

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

若你想安装Homebrew中没有的Python应用，最简单的方式是使用'pipx install xyz'，它会为你管理虚拟环境。你可以通过以下命令安装pipx：

brew install pipx

你可以通过向pip传递'--break-system-packages'参数，或在pip.conf文件中添加'break-system-packages = true'来恢复pip的旧行为，后者会永久禁用该错误。

若你禁用该错误，我们强烈建议你同时向pip传递'--user'参数，或在pip.conf文件中设置'user = true'。否则可能会导致Homebrew安装损坏。

在此了解更多相关行为：<https://peps.python.org/pep-0668/>

note: 若你认为这是错误，请联系你的Python安装或操作系统发行商。你可以通过传递--break-system-packages来覆盖此限制，但可能会损坏Python安装或操作系统。
hint: 详见PEP 668的详细规范。

[notice] pip有新版本可用：24.0 -> 24.1.2
[notice] 如需更新，请运行：python3.12 -m pip install --upgrade pip

另外，执行brew install matplotlib时命令长时间卡住，而在虚拟环境中安装仅需几分钟。

问题原因 #

1. externally-managed-environment错误：这是PEP 668规范的要求，MacOS系统自带或Homebrew安装的Python被标记为外部管理环境，目的是防止全局安装的包破坏系统依赖或Homebrew的安装环境。
2. brew安装缓慢：Homebrew安装Python包时会编译底层依赖库（比如matplotlib依赖的C/C++组件），同时可能受网络影响导致下载延迟，因此耗时远超过虚拟环境中直接安装预编译的wheel包。

解决方法 #

临时绕过限制全局安装 #

若确实需要全局安装，可在pip命令后添加--break-system-packages参数：

pip3 install matplotlib --break-system-packages

⚠️ 建议搭配--user参数将包安装到用户目录，避免影响全局依赖：

pip3 install matplotlib --break-system-packages --user

永久禁用错误提示 #

通过修改pip配置文件实现永久绕过：

1. 创建pip配置目录（若不存在）：

mkdir -p ~/.config/pip

2. 编辑pip.conf文件：

nano ~/.config/pip/pip.conf

3. 添加以下配置内容，永久启用绕过限制并默认安装到用户目录：

[global]
break-system-packages = true
user = true

保存退出后，后续使用pip3 install将不再触发该错误。

使用pipx管理全局Python应用（推荐） #

pipx会为每个Python应用创建独立虚拟环境，既实现全局可访问，又不破坏系统环境：

1. 安装pipx：

brew install pipx

2. 初始化pipx（确保命令可全局调用）：

pipx ensurepath

3. 安装matplotlib：

pipx install matplotlib

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