跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

macOS 下升级 Python 的几种主流方案

macOS 环境下升级 Python 需先确认当前安装方式,避免修改系统自带版本。推荐通过 Homebrew 安装最新版,或使用 pyenv 管理多版本项目依赖。若使用 Anaconda 则更新 conda 环境。注意检查 PATH 环境变量,确保新路径优先于系统路径。升级后记得重新安装项目依赖以防兼容性问题。

zhang发布于 2026/3/24更新于 2026/11/692 浏览
macOS 下升级 Python 的几种主流方案

在 macOS 环境下升级 Python,具体操作取决于你最初是如何安装的。了解当前的安装方式至关重要,否则盲目操作可能会影响系统稳定性。

首先确认一下当前环境的状态:

python --version # 可能指向 Python 2.x
python3 --version # 通常指向 Python 3.x
which python
which python3

根据 which 命令的输出,我们可以判断出安装来源。常见的情况有:

  • macOS 系统自带 Python:路径通常在 /usr/bin/python。强烈建议不要直接修改或升级它,因为 macOS 内部工具依赖它,强行操作可能导致系统异常。
  • Homebrew 安装:路径通常在 /usr/local/bin/python3 (Intel) 或 /opt/homebrew/bin/python3 (Apple Silicon)。这是 Mac 用户最推荐的管理方式。
  • pyenv 安装:路径通常在 ~/.pyenv/shims/python。适合需要频繁切换版本的项目开发。
  • Anaconda/Miniconda 安装:路径通常在 ~/anaconda3/bin/python。数据科学领域常用。
  • 官网安装包 (pkg):通常安装在 /Library/Frameworks/Python.framework。

下面针对不同场景给出具体的升级方案。

首选方案:使用 Homebrew

Homebrew 是 macOS 上最流行的包管理器,也是管理 Python 的最佳选择之一。

1. 安装与更新 Homebrew

如果还没装,先运行以下命令(注意空格):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后,记得更新 Homebrew 本身:

brew update

2. 升级 Python

如果你的 Python 是通过 Homebrew 安装的,直接升级即可:

brew upgrade python

这会将其升级到最新稳定版。如果还没装,也可以直接安装:

brew install python

3. 检查 PATH 环境变量

Homebrew 通常会自动配置 PATH,但为了保险起见,检查一下你的 shell 配置文件(~/.zshrc 或 ~/.bash_profile)。确保 Homebrew 的路径排在前面:

# Intel Mac
export PATH="/usr/local/opt/python/libexec/bin:$PATH"
export PATH="/usr/local/bin:"


 PATH=
 PATH=
$PATH
# M1/M2 Mac
export
"/opt/homebrew/opt/python/libexec/bin:$PATH"
export
"/opt/homebrew/bin:$PATH"

修改后执行 source ~/.zshrc 生效,然后验证:

python3 --version
which python3

多版本管理:使用 pyenv

如果你需要在同一台机器上维护多个 Python 版本(比如项目 A 用 3.8,项目 B 用 3.10),pyenv 是绝佳工具。

1. 安装与初始化

通过 Homebrew 安装:

brew install pyenv

接着编辑 ~/.zshrc 添加初始化代码:

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"

保存后 source ~/.zshrc。

2. 安装与切换版本

列出可用版本:

pyenv install --list

安装新版本(例如 3.11.4):

pyenv install 3.11.4

设置全局版本(对所有终端生效):

pyenv global 3.11.4

或者在项目目录下设置局部版本:

pyenv local 3.11.4

验证时,pyenv 会通过 shim 机制自动接管 python 命令。

数据科学环境:Anaconda/Miniconda

如果你依赖 Conda 管理环境,升级逻辑略有不同。

1. 更新 Conda

conda update conda

2. 升级 Python

虽然可以直接升级 base 环境中的 Python,但更推荐的做法是创建新环境,避免污染基础库:

conda create -n my_new_env python=3.11
conda activate my_new_env
python --version

这样每个项目都有独立的依赖隔离,互不干扰。

官网安装包升级

如果是从 python.org 下载的 .pkg 文件:

  1. 访问 https://www.python.org/downloads/macos/。
  2. 下载最新版安装程序。
  3. 运行 .pkg 文件,按向导完成安装。

注意:这种方法容易在系统中残留多个版本,且 PATH 管理不如前两者灵活,仅建议在特定需求下使用。

最佳实践总结

  • 严禁修改系统自带 Python (/usr/bin/python),那是 macOS 的命根子。
  • 普通用户首选 Homebrew,简单省心。
  • 多版本需求选 pyenv,灵活性最高。
  • 数据科学工作流选 Conda,库管理更强大。
  • 升级后记得重装依赖 (pip install -r requirements.txt),防止兼容性问题。
  • 记得刷新环境变量,新开一个终端会话或使用 source 命令后再检查版本。

根据你的实际工作流程选择最适合的工具,别被版本问题卡住脖子。

目录

  1. 首选方案:使用 Homebrew
  2. 1. 安装与更新 Homebrew
  3. 2. 升级 Python
  4. 3. 检查 PATH 环境变量
  5. Intel Mac
  6. M1/M2 Mac
  7. 多版本管理:使用 pyenv
  8. 1. 安装与初始化
  9. 2. 安装与切换版本
  10. 数据科学环境:Anaconda/Miniconda
  11. 1. 更新 Conda
  12. 2. 升级 Python
  13. 官网安装包升级
  14. 最佳实践总结

更多推荐文章

查看全部
  • 节点小宝 4.0 macOS 客户端发布:原生远程文件与跨设备同步
  • 十大中国流行 AI 大模型企业及平台汇总
  • SpringBoot 整合 Java DL4J 构建自然语言处理智能写作助手
  • 利用 Java GUI 编写简单文本编辑器
  • OpenAI 与 LangChain 集成实战使用详解
  • JDK 下载、安装与环境变量配置教程
  • Linux 命名管道(FIFO)通信:原理与跨进程实战
  • AI 时代超级能动性:重建个人掌控力的关键能力
  • VSCode 精准控制 Copilot 补全:按语言与场景灵活配置
  • Ubuntu 24.04 系统下 VNC Server 完整安装与配置指南
  • GLM-4.6V-Flash-WEB 与 Qwen-VL 视觉理解部署评测对比
  • 深度学习与 AI 大模型技术指南
  • Dubbo 源码解析:与 Spring 如何实现无缝对接
  • Flask 入门:数据库记录集转换为 JSON 返回
  • AI 写作辅助平台评测:炼字工坊与蛙蛙写作深度解析
  • 集成 Linly-Talker 实现智能客服数字人
  • MS-S1 MAX 与 AI MAX 395 在 Ubuntu 24 下使用 Vulkan llama.cpp 运行 gpt-oss 120b
  • WebGoat JWT 漏洞实战:第六关与第十一关逻辑越权解析
  • NumPy 与 Pandas 数据分析基础
  • OpenClaw AI 智能体本地部署与实战指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online