macOS 如何安装 pip
macOS 上 pip 随 Python 而来:brew install python 后自带 pip3;或 python3 -m ensurepip 补装。本文覆盖 Homebrew、官方安装包两条路径及 PATH 配置。
一句话回答:使用 Homebrew 或 python.org 标准安装器安装 Python 时通常附带 pip,系统/裁剪版本不能一概而论。最推荐 Homebrew:brew install python,装完直接有 pip3;验证用 python3 -m pip --version。已有 Python 但缺 pip 时执行 python3 -m ensurepip --upgrade 即可补上。
方案一:Homebrew(推荐)
brew install python
装完即得 python3 和 pip3(位于 /opt/homebrew/bin,Apple Silicon;Intel 在 /usr/local/bin)。验证:
python3 --version
python3 -m pip --version
方案二:python.org 官方安装包
从 python.org 下载 macOS 安装包,安装后自带 pip。安装后还需运行一次证书配置脚本(安装目录里的 Install Certificates.command),否则 HTTPS 请求会报证书错误——这是官方包在 macOS 上的经典坑。
已有 Python 但缺 pip
python3 -m ensurepip --upgrade
不要对 Apple/Xcode 管理的 /usr/bin/python3 直接引导或升级 pip,也不要尝试绕过系统保护。ensurepip 适用于自行管理且提供该模块的 Python;Homebrew 的 pip 由 brew 管理,项目包放入 venv。
装好之后
# 项目开发一律用虚拟环境
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip # 仅升级虚拟环境里的 pip
python -m pip install requests
常见问题(FAQ)
Q:pip 和 pip3 有什么区别?
A:macOS 上历史遗留:python/pip 曾指 Python 2(新版 macOS 已移除),python3/pip3 指 Python 3。统一用 python3 -m pip,最不容易指错。
Q:brew 装的 Python 提示 externally-managed?
A:Homebrew Python 遵循 PEP 668,禁止直接往它的环境装包。正确姿势:每个项目建 venv;命令行工具用 brew install pipx && pipx install 工具名。
Q:M 系列芯片装包编译报错?
A:先确认装的是 arm64 原生 Python(brew 默认就是)。纯 Python 包无影响;带 C 扩展的包需有匹配 Python 版本、ABI 与 arm64/universal2 的 wheel;缺少时仍可能编译,升级 pip 不能创造不存在的 wheel。
核查依据
本文依据官方文档核对,示例未在实际业务环境运行;上线前请按部署版本、权限与数据范围验证。