pip怎么在Mac系统上正确安装

酷敏小哥_9764

酷敏小哥_9764

2026-09-02

467人浏览

原创

Mac上pip命令找不到,根本原因是pip3虽已随Python 3安装,但未被shell识别:PATH未包含其路径,或系统仍调用无pip的旧Python;验证可用python3 -m pip --version,修复需确保Homebrew安装的python包(含pip3)路径加入PATH,或手动配置~/.zshrc别名。

pip怎么在mac系统上正确安装

Mac 上 pip 通常已随 Python 3 一起安装,但直接运行 pip 命令失败,大概率不是没装,而是没配对、没暴露、或被系统路径遮蔽。

为什么 pip 命令找不到?

macOS 自 12.3 起不再预装 Python 2,但也不会默认安装 Python 3 或 pip;即使你用 Homebrew 或官网安装了 Python 3,pip 二进制文件(如 pip3)可能不在 $PATH 中,或者系统仍优先调用旧的 /usr/bin/python(不带 pip)。

  • 运行 python3 -m pip --version 成功 → 说明 pip 已存在,只是命令未注册到 shell
  • 运行 which pip 或 which pip3 返回空 → 表明 shell 找不到可执行文件
  • 运行 python3 --version 失败 → 说明 Python 3 根本没装,得先解决这个

最稳妥的安装路径:用 Homebrew 装 Python 3(含 pip)

Homebrew 安装的 Python 3 自带 pip3,且会自动把 /opt/homebrew/bin(Apple Silicon)或 /usr/local/bin(Intel)加入 $PATH,避免手动改配置。

  • 先装 Homebrew(若未装):curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
  • 再装 Python:brew install python(注意:不是 python3,Homebrew 的 python 包即指 Python 3)
  • 验证:python3 --version 和 python3 -m pip --version 都应返回版本号
  • 此时 pip3 可用;如需 pip 简写,可加别名:echo "alias pip=pip3" >> ~/.zshrc && source ~/.zshrc

如果必须用官网安装包,要注意 PATH 设置

从 python.org 下载的 macOS 安装器(.pkg)默认勾选「Add Python to PATH」,但该选项只修改 ~/.zprofile(zsh)或 ~/.bash_profile(bash),而 macOS Catalina 及以后默认用 zsh,且部分终端启动方式会跳过这些文件。

Buildkite Dynamic Pipeline Architect
Buildkite Dynamic Pipeline Architect

使用 Buildkite REST API 和 pipeline upload 机制创建动态 Buildkite 流水线。基于通过 git diff 检测文件变更实现条件步骤生成。

下载
  • 检查是否已写入:cat ~/.zprofile | grep "/Library/Frameworks/Python.framework"
  • 若无输出,手动添加:echo 'export PATH="/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH"' >> ~/.zprofile
  • 然后重载:source ~/.zprofile
  • 再试 pip3 --version;若仍不行,确认安装路径是否为 /Library/Frameworks/Python.framework/Versions/3.x/bin/pip3,并替换上面的路径

别用 sudo pip install get-pip.py 这类操作

这是早期文档遗留的危险做法,它会把 pip 写进系统 Python(/usr/bin/python3)的 site-packages,极易破坏 macOS 自带工具链(比如 softwareupdate 依赖的模块)。2026 年起,Apple 对 /usr 下的写入限制更严格,这类命令大概率报错或静默失败。

  • 绝对不要运行:sudo pip install --upgrade pip 或 sudo python get-pip.py
  • 如果已误操作,建议用 brew uninstall python + brew install python 彻底重置
  • 临时救急可用:python3 -m ensurepip --upgrade(仅当 ensurepip 模块存在时)

真正卡住的地方,往往不是“怎么装”,而是“装完后 shell 找不到它”——重点盯住 $PATH 和 shell 配置文件的加载顺序,比反复重装 Python 有效得多。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

3710

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

8403

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

10142

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

5367

16

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python虚拟环境官方教程
Python虚拟环境官方教程

共0课时 | 0人学习

pip安装和使用保姆级教程
pip安装和使用保姆级教程

共0课时 | 0人学习

Conan 2 安装指南
Conan 2 安装指南

共0课时 | 0人学习