Python与pip配置异常导致包安装路径错误及虚拟环境失效问题

问题根源 #

你的系统中同时存在Command Line Tools自带的Python3.9和Homebrew安装的Python3.9，PATH环境变量中系统路径优先级更高，导致pip的实际安装行为和显示的版本信息不一致；同时你用系统Python创建虚拟环境，激活后运行脚本时可能未正确使用虚拟环境的Python解释器。

解决步骤 #

1. 定位Homebrew安装的Python3.9路径 #

执行以下命令获取Homebrew安装的Python3.9的具体路径：

brew info python@3.9

输出中会显示类似/usr/local/Cellar/python@3.9/3.9.6/bin/python3的路径，记下来这个路径。

2. 调整PATH优先级，让Homebrew Python优先 #

编辑你的shell配置文件（zsh用户修改~/.zshrc，bash用户修改~/.bash_profile），添加以下内容（替换成上一步获取的实际路径）：

export PATH="/usr/local/Cellar/python@3.9/3.9.6/bin:$PATH"

保存后执行以下命令使配置生效：

source ~/.zshrc  # zsh用户执行
# 或 source ~/.bash_profile  # bash用户执行

3. 验证路径是否正确 #

执行以下命令，确认输出的路径是Homebrew安装的Python3.9目录：

which python3
which pip3

再验证版本一致性：

python3 -V  # 应输出Python 3.9.6
pip3 --version  # 应指向Homebrew路径下的pip

4. 重新创建并使用虚拟环境 #

用调整后的Python创建虚拟环境：

python3 -m venv venv

激活虚拟环境：

source venv/bin/activate

激活后终端会显示(venv)前缀，此时安装包：

pip install --upgrade google-cloud-storage

5. 验证安装并运行脚本 #

在虚拟环境激活状态下，执行pip list，应该能看到google-cloud-storage包。然后运行你的脚本：

python main.py

额外注意事项 #

• 确保运行脚本时虚拟环境处于激活状态，否则会使用系统Python解释器，导致找不到包。
• 若之前的虚拟环境有残留，可直接删除旧的venv目录后重新创建。

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