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

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

技术背景

pip 是 Python 的包管理工具,它可以方便地安装、升级和管理 Python 包。在 macOS 或 OS X 系统中,有时候需要手动安装 pip 来使用各种 Python 库。由于 macOS 自带的 Python 版本可能较旧,或者没有预装 pip,因此掌握在该系统上安装 pip 的方法十分必要。

实现步骤

方法一:使用 ensurepip 模块

  • 使用 Python 自带命令:在 Linux 或 MacOS 上,可以使用 Python 自带的 ensurepip 模块来安装或升级 pip。
1
python -m ensurepip --upgrade

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

1
python3 -m ensurepip --upgrade

方法二:使用 curl 下载脚本安装

  • Python 2.7(截至 2021 年 Mac 默认版本)
1
curl https://bootstrap.pypa.io/pip/2.7/get-pip.py | python
  • Python 3
1
curl https://bootstrap.pypa.io/get-pip.py | python

或者如果你系统中 Python 3 安装为 python3

1
curl https://bootstrap.pypa.io/get-pip.py | python3

方法三:使用 Homebrew 安装

  • 安装 Homebrew:如果还未安装 Homebrew,可以使用以下命令安装:
1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • 安装 Python 和 pip:安装最新的 Python,同时会安装 Pip 和 Setuptools:
1
brew install python

如果需要 Python 3,可以使用:

1
brew install python3

安装后,如果 pip 不在路径中,可能需要重新链接:

1
brew unlink python && brew link python

方法四:手动下载脚本安装

  • 下载 get-pip.py 脚本:可以从 pip 官方文档 下载 get-pip.py 文件。
  • 运行脚本:确保你在 get-pip.py 文件所在目录,然后运行以下命令:
1
sudo python get-pip.py

如果是 Python 3,使用:

1
sudo python3 get-pip.py

核心代码

以下是几种常见安装方法的核心代码示例:

使用 ensurepip

1
python -m ensurepip --upgrade

使用 curl 安装 Python 3 的 pip

1
curl https://bootstrap.pypa.io/get-pip.py | python3

使用 Homebrew 安装 Python 和 pip

1
brew install python3

最佳实践

  • 使用虚拟环境:在安装和使用 Python 包时,建议使用虚拟环境,如 venvvirtualenv,以避免不同项目之间的包冲突。创建和激活虚拟环境的示例代码如下:
1
2
python3 -m venv myenv
source myenv/bin/activate
  • 定期更新 pip:安装好 pip 后,定期更新它以获取最新的功能和安全修复:
1
pip install --upgrade pip

常见问题

权限问题

在安装过程中,可能会遇到权限问题,提示 Permission denied。可以尝试使用 sudo 命令获取管理员权限:

1
sudo pip install package_name

或者使用 --user 选项将包安装到用户目录:

1
pip install --user package_name

网络问题

如果在下载 get-pip.py 或安装包时遇到网络问题,可能是由于网络不稳定或代理设置不正确。可以检查网络连接,或者设置正确的代理:

1
2
export http_proxy=http://proxy.example.com:port
export https_proxy=http://proxy.example.com:port

pip 未找到问题

如果安装后 pip 命令无法找到,可能是因为 pip 所在路径未添加到系统环境变量中。可以检查 PATH 环境变量,或者重新链接 Python:

1
brew unlink python && brew link python

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