Homebrew Python使用pip安装模块时报distutils配置弃用警告如何解决？

数据老陈

2026-10-2

方案1：安装包时追加--user参数
执行安装命令时修改为：
```
pip install --user -r requirements.txt
```
该方式会将依赖包安装到当前用户的专属目录，规避调用brew自带的distutils全局配置，直接消除警告。
方案2：升级pip到最新适配版本
直接通过brew安装的python本体升级pip，适配brew的目录结构：
- Intel芯片Mac执行：
```
/usr/local/bin/python3 -m pip install --upgrade pip
```
- M系列ARM芯片Mac执行：
```
/opt/homebrew/bin/python3 -m pip install --upgrade pip
```
新版本pip已经修复了和brew python的配置兼容问题，升级后默认不会触发该弃用警告。
方案3：设置pip全局默认走用户安装模式
不需要每次手动加参数，执行一次配置命令即可：
```
pip config set global.user true
```
后续所有pip install操作默认都会使用用户目录安装，自动规避该警告。
方案4（推荐开发场景使用）：使用独立虚拟环境
创建项目专属的虚拟环境，完全隔离全局python配置：
1. 执行创建虚拟环境命令：python3 -m venv 你的虚拟环境名称
2. 激活虚拟环境：source 你的虚拟环境名称/bin/activate
3. 激活后正常执行pip install -r requirements.txt即可，不会触发任何和全局brew python相关的警告，同时不会污染全局依赖环境。