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。

核查依据

本文依据官方文档核对,示例未在实际业务环境运行;上线前请按部署版本、权限与数据范围验证。


延伸阅读

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台