在 Mac 上安装 Python
所有最新的 MacOS(从 macOS 12.3 开始)都预装了 Python 版本(通常是 Python 2.x),但它已经过时并且不再受支持。要充分利用 Python 的功能,您需要安装 最新版本的 Python。
在 macOS 设备上安装 Python 的完整步骤。内容包括检查预装版本、通过 Homebrew 安装 Python 及 pip、验证安装、配置环境变量 PATH,以及从官方网站安装的替代方案。此外还涵盖了常见问题排查、IDE 推荐及常用库安装方法,帮助用户在 Mac 上顺利搭建 Python 开发环境。
所有最新的 MacOS(从 macOS 12.3 开始)都预装了 Python 版本(通常是 Python 2.x),但它已经过时并且不再受支持。要充分利用 Python 的功能,您需要安装 最新版本的 Python。
本文提供了分步教程,展示了在 macOS(MacBook 旧版本和新版本,如 M1、M2、M3 或 M4)上安装和更新 Python 的所有有效方法,从检查预安装版本到下载和更新最新的 Python 并设置基本工具(如 IDE 和包管理器),本指南将帮助您轻松地在任何 MacBook 设备上安装 Python。
以下是在 MacOS 上检查预装 Python 版本的快速简便的步骤,以便您可以使用终端和 Homebrew 直接更新 Python 最新版本。
按下 Command + Space,输入 Terminal,然后按 Enter 键。
运行以下命令检查已安装的 Python 3 版本:
python3 --version
出现弹出窗口提示 xcode-select 命令需要命令行开发人员工具。您想立即安装该工具吗?安装 Homebrew(或有时直接安装 Python)时,你可能会看到一个弹出窗口,提示你安装命令行开发人员工具。许多 macOS 开发任务都需要这些工具,包括 Python 安装。
解决方案:当您看到弹出窗口要求您安装'命令行开发人员工具'时,请单击'安装',然后等待一段时间以下载该软件。确保您已连接到稳定的 Wi-Fi 网络。
排除命令行开发人员工具安装失败错误
通过运行手动安装工具:
xcode-select --install
如果您看到类似内容 Python 3.x.x(如下图所示,显示的是 Python 3.9.6),则表示已安装 Python 3。现在,我们将按照本指南中下面提到的进一步步骤确保版本与最新安装的版本(例如 Python 3.13.x)匹配。
如果命令返回错误或未显示版本,则表示未安装 Python 3。
故障排除:
Homebrew 是 macOS 的软件包管理器,可简化软件安装,包括 Python。为了使用 Brew 在 Mac 上安装 Python,您首先需要在 Mac 设备上安装 Homebrew。即使您的 Mac 设备上已预装 Python,也可以按照以下简单步骤在 Mac 上安装 Homebrew:
使用快捷键 Command + Space,输入 Terminal,然后按 Enter。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
检查 Sudo 访问权限时,系统可能会提示您输入密码。
重要提示:什么是'检查 sudo 访问权限(可能需要您输入密码)'
Homebrew 本身不需要 sudo 运行。但是,安装程序 sudo 在初始设置期间会使用它来创建必要的安装目录 /opt/homebrew 并配置其权限。此外,sudo 如果尚未安装,则用于安装和配置 Xcode 命令行工具。一旦 Homebrew 安装并设置完毕,它就不再需要 sudo 执行任何操作。
下一步: 在您的终端中运行这些命令将 Homebrew 添加到您的 PATH:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
在所有以上给出的命令中,将'userprofile'更改为您设备的实际用户名(此处使用标准路径)。
安装完成后,通过运行以下命令验证 Homebrew:
brew --version
您应该会看到一个版本号,确认 Homebrew 已安装。
重要提示: 如果您看到安装了旧版本的 Homebrew,请运行以下命令来更新 Homebrew:
brew update
现在让我们开始在你的 Mac 设备上安装 Python 最新版本,使用 Homebrew 是安装 Python 3 最新版本的最简单方法,因为它可以确保你获得最新的稳定版本。
按下 Command + Space,输入 Terminal,然后按 Enter 键。
此命令将下载并安装 Python 3 最新版本以及 Python 包管理器 pip。
brew install python
等待该过程完成。您可能会看到 Homebrew 下载并安装依赖项时的进度指示器。
python3 --version
如果安装正确,您将看到版本号(例如,Python 3.13.1)。
pip3 --version
如果 pip3 已安装,它将显示其版本。
以下是在 Mac 上安装 Python 时出现的最常见问题,所有这些错误和问题看起来很难,但只需几个快速步骤就可以很容易地修复:
运行以下命令确保 Homebrew 已正确安装。现在运行以下命令,以修复与 Homebrew 未在终端中运行相关的任何问题。
brew doctor
现在按下回车键后,它将显示问题,如果报告了问题,请按照建议的修复方式进行操作。
通过在终端中复制并粘贴以下命令重新安装 Python。
brew reinstall python
测试确保 Python 设置正确并可供使用。
按下 Command + Space,输入 Terminal,然后按 Enter 键。
python3
您将看到一个 >>> 提示,表明 Python 已准备就绪。
print("Hello, Python!")
如果您看到'Hello, Python!',则表明 Python 运行正常。
exit()
如果 python3 command 安装后不起作用,您可能需要将 Python 添加到系统 PATH。
使用快捷键 Command + Space,输入 Terminal,然后按 Enter。
对于 macOS Catalina 或更高版本(默认 shell 是 Zsh):
nano ~/.zshrc
对于较旧的 macOS 版本(默认 shell 是 Bash):
nano ~/.bash_profile
在文件末尾添加以下行:
export PATH="/usr/local/opt/python/libexec/bin:$PATH"
按 Ctrl + O,然后按 Enter,接着按 Ctrl + X。
现在使用以下命令重新加载配置,将 Python 添加到 Mac 上的 PATH:
source ~/.zshrc
现在验证上述步骤以预览 Mac 上 Python 安装的 PATH 变化,如果出现版本,则表示 Python 3 已成功添加到 PATH。
运行以下命令:
python3 --version
访问 Python 官方网站 并下载适用于 macOS 的安装程序。
打开 .pkg 文件并按照安装步骤进行。
python3 --version
如果您在从 Python.Org 在 Mac 上安装 Python 时仍然遇到困难,请查看 官方文档。
虽然您可以在任何文本编辑器中编写 Python 脚本,但使用集成开发环境 (IDE) 可以使编码更容易、更高效。
为了扩展 Python 的功能,您可以使用 pip3 安装库。
流行的 Python 库:
使用快捷键打开 Terminal,按 Enter。
pip3 install library_name
替换 library_name 为您要安装的库,例如 numpy。
在 Mac 上安装 Python 为编程、数据分析和自动化任务打开了机遇之门。通过遵循本分步指南,您可以无缝设置 Python,确保与最新工具和框架兼容。
从 Web 开发和机器学习到脚本自动化,Python 可让您轻松处理各种任务。随着 Python 在数据科学、人工智能和软件开发领域的日益普及,在 Mac 上安装和运行 Python 是提高您的技术技能和生产力的关键一步。
访问 Python 官方网站并下载适用于 macOS 的 Python 3.13 的安装程序。双击下载的 .pkg 文件并按照安装提示进行操作。安装后,通过 python3 --version 在终端中输入进行验证。
打开终端。输入 python3 --version 或 python --version。如果安装了 Python,它将显示版本号。如果没有安装,您将看到'未找到命令'错误。
如果已经安装了 Python,pip 通常会预装 Python 3。使用 python3 -m ensurepip --upgrade 以确保 pip 可用。
如果没有,请运行以下命令安装 pip:
python3 -m ensurepip
python3 -m pip install --upgrade pip
通过在终端中输入 pip --version 来确认安装。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online