在macOS或OS X上安装pip的方法

在macOS或OS X上安装pip的方法

技术背景

pip 是 Python 的包管理工具,它能帮助用户方便地安装、升级和管理 Python 包。macOS 或 OS X 系统通常自带 Python 环境,但不一定预装了 pip。因此,需要手动安装 pip 来更高效地管理 Python 包。

实现步骤

方法一:使用 ensurepip

在 Linux 或 MacOS 系统中,可以使用以下命令来安装或升级 pip:

1
python -m ensurepip --upgrade

如果要为 Python 3 安装 pip,将 python 替换为 python3

1
python3 -m ensurepip --upgrade

方法二:使用 get-pip.py

  1. 下载 get-pip.py 文件:
1
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
  1. 运行以下命令安装 pip:
1
sudo python get-pip.py

如果是为 Python 3 安装,使用:

1
sudo python3 get-pip.py

方法三:使用 Homebrew

  1. 安装 Homebrew(如果未安装):
1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. 安装 Python:
1
brew install python

安装 Python 3 后,pip3 会自动安装。若要使用 pip 命令指向 Python 3,可以添加别名:

1
2
echo 'alias pip=pip3' >> ~/.zshrc
source ~/.zshrc

方法四:使用 easy_install(不推荐,已弃用)

在 2019 年之前,可以使用以下命令安装 pip:

1
sudo easy_install pip

easy_install 已被弃用,不建议使用。

方法五:使用 uv(2025 年新方案)

uv 是一个用 Rust 编写的工具,可用于虚拟环境管理。

  1. 安装 uv:
1
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 安装 Python:
1
2
uv python install 3.12.7
uv venv --python 3.12.7

核心代码

使用 ensurepip 安装 pip

1
python -m ensurepip --upgrade

使用 get-pip.py 安装 pip

1
2
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
sudo python get-pip.py

使用 Homebrew 安装 Python 和 pip

1
brew install python

最佳实践

  • 优先使用 get-pip.py 方法,因为它能确保为当前使用的 Python 版本安装 pip。
  • 使用 Homebrew 安装 Python 时,能方便地管理 Python 版本和依赖。
  • 对于新的项目,建议使用虚拟环境(如 venv)来隔离项目依赖。

常见问题

安装后 pip 命令不可用

  • 检查是否正确安装了 Python 和 pip。
  • 确认 pip 命令是否在系统的环境变量中。可以通过 which pip 命令检查。

easy_install 报错

easy_install 已被弃用,建议使用其他方法安装 pip。

同时安装了 Python 2 和 Python 3

明确使用 pip2pip3 来区分不同版本的 Python,避免混淆。例如:

1
2
pip2 install package_name  # 为 Python 2 安装包
pip3 install package_name # 为 Python 3 安装包

在macOS或OS X上安装pip的方法
https://119291.xyz/posts/install-pip-on-macos-or-os-x/
作者
ww
发布于
2025年5月29日
许可协议