macOS 下 Python 包管理器 pip 与 pipx 之高效使用

pip专管Python库（如requests、numpy），pipx专管命令行工具（如black、poetry），二者用途分明：pip用于项目依赖导入，pipx为每个CLI工具创建隔离环境并全局调用，混用易污染环境，分开使用更安全高效。

macos 上 python 包管理要分清用途：pip 专管库（比如 requests、numpy），pipx 专管可执行工具（比如 black、poetry、httpx）。混用容易污染环境，分开用才清爽高效。

确认 pip 已就绪并升级到最新版

macOS 自 12.3 起不再预装 Python，所以 pip 很可能没随系统自带。先检查是否可用：

• 终端运行 python3 --version 确认 Python 3 已安装
• 再运行 python3 -m pip --version —— 若报错 “no module named pip”，说明缺失，需手动安装
• 缺失时执行：
  curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py
• 无论是否新装，都建议升级：
  python3 -m pip install --upgrade pip

用 pipx 安装和运行命令行工具

pipx 不是 pip 的替代品，而是互补工具。它为每个 Python 应用创建独立虚拟环境，装完就能直接在终端调用，且互不干扰。

• 推荐用 Homebrew 安装（最稳定）：
  brew install pipx
pipx ensurepath
• 安装后重启终端，或运行 source ~/.zshrc（默认 shell 是 zsh）
• 验证：pipx --version
• 装一个常用工具试试：
  pipx install black → 装完直接可用 black --help
• 卸载也干净：pipx uninstall black

配置国内镜像源提升下载速度

默认 PyPI 源在国外，直连常超时或缓慢。推荐清华源，永久生效只需一步：

• 执行命令一键配置：
  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
• 如需临时换源（比如只装某一个包）：
  pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ httpx
• 其他可靠镜像源（备用）：
  中科大：https://pypi.mirrors.ustc.edu.cn/simple/
  阿里云：https://mirrors.aliyun.com/pypi/simple/

区分使用场景，避免踩坑

什么时候该用 pip？什么时候该用 pipx？关键看你要装的是“库”还是“命令行程序”：

立即学习“Python免费学习笔记（深入）”；

• 装开发依赖（pytest、flake8）或项目库（django、fastapi）→ 用 pip install（最好在 venv 里）
• 装全局可用的 CLI 工具（poetry、pyenv、rich-cli）→ 用 pipx install
• 不要用 pip 全局装 CLI 工具（易冲突、难卸载）
• 不要用 pipx 装项目依赖库（它不提供 import 能力，只提供命令入口）