Python安装 - macOS

方法一：使用Homebrew安装Python（推荐）

Homebrew是macOS平台上最受欢迎的开源包管理器，它能帮助你轻松安装、升级和管理各种开发工具。通过Homebrew安装Python是最推荐的方式，因为它能自动处理依赖关系，并且后续升级非常方便。

第一步：安装Homebrew

如果你的Mac上还没有安装Homebrew，需要先完成安装。打开终端应用（Terminal.app），复制并执行以下命令：

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

安装过程中，终端会提示你需要安装Xcode命令行工具，按照提示操作即可。安装完成后，需要将Homebrew添加到系统环境变量PATH中。

针对Apple Silicon芯片（M1/M2/M3）的Mac：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

针对Intel芯片的Mac：

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

第二步：安装Python

Homebrew安装完成后，只需一条命令即可安装最新版本的Python 3：

brew install python

执行该命令后，Homebrew会自动下载并安装Python 3，同时还会附带安装pip包管理工具和setuptools，无需额外操作。

安装特定版本的Python

如果你的项目需要特定版本的Python，Homebrew也提供了灵活的版本选择：

brew install python@3.11
brew install python@3.12

升级Python版本

当Python发布新版本时，你可以通过简单的命令完成升级：

brew upgrade python

查看Python安装详情

想了解已安装Python的详细信息，包括安装路径和版本，可以执行：

brew info python

方法二：使用Python官方安装包安装

如果你不想使用Homebrew，或者更喜欢图形化安装方式，Python官网提供了适用于macOS的安装包，安装过程简单直观。

下载安装包

访问Python官方下载页面：https://www.python.org/downloads/macos/

在下载页面中，你会看到适用于macOS的安装包。推荐选择macOS 64-bit universal2 installer版本，因为它同时支持Apple Silicon和Intel两种芯片架构：

提示：universal2安装包是通用二进制格式，无论你使用的是哪种芯片的Mac，都可以正常使用，建议优先下载此版本。

运行安装程序

下载完成后，双击.pkg文件启动安装向导，按照以下步骤操作：

• 点击"继续"阅读安装说明

• 阅读并同意软件许可协议

• 选择安装位置（保持默认即可）

• 点击"安装"按钮

• 输入你的Mac管理员密码

• 等待安装完成

安装完成后的文件

安装成功后，系统会自动在/Applications目录下创建Python 3.12文件夹，其中包含：

• IDLE：Python的集成开发环境

• Python文档：离线版Python参考文档

• Update Shell Profile：自动配置环境变量的脚本

环境变量配置详解

正确配置环境变量是确保你能在终端中随时使用Python命令的关键步骤。

确认当前使用的Shell

首先，你需要知道你的Mac使用的是哪种命令行解释器：

echo $SHELL

从macOS Catalina（10.15）开始，系统默认使用zsh作为命令行Shell。更早期的版本则使用bash。

zsh环境配置（macOS默认）

如果你使用的是zsh，需要编辑~/.zshrc配置文件：

nano ~/.zshrc

在文件末尾添加以下配置行：

官方安装包安装的配置：

export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"

Homebrew安装的配置（Apple Silicon）：

export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"

Homebrew安装的配置（Intel）：

export PATH="/usr/local/bin:$PATH"

保存文件后（nano编辑器中按Ctrl+O保存，Ctrl+X退出），执行以下命令使配置立即生效：

source ~/.zshrc

bash环境配置

如果你使用的是bash，编辑~/.bash_profile文件：

nano ~/.bash_profile

添加与上述相同的PATH配置，保存后执行：

source ~/.bash_profile

设置python命令指向python3

macOS系统自带的Python 2使用的是python命令，而新安装的Python 3默认使用python3命令。如果你希望直接输入python就能使用Python 3，可以在配置文件中添加别名：

alias python='python3'
alias pip='pip3'

保存配置文件后，执行source ~/.zshrc（或source ~/.bash_profile）使别名生效。

验证安装是否成功

安装完成后，需要通过终端命令来验证Python是否正确安装。

检查Python版本

在终端中执行：

python3 --version

如果安装成功，你将看到类似以下的输出：

Python 3.12.x

检查pip是否安装

验证pip包管理器是否正常：

pip3 --version

正常输出应显示pip版本和Python路径信息：

pip 24.x from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)

运行Python环境检测脚本

你可以创建一个Python脚本来全面检测系统环境信息。创建文件check_python.py，输入以下代码：

import sys
import platform

print(f"Python版本: {sys.version}")
print(f"Python路径: {sys.executable}")
print(f"操作系统: {platform.system()} {platform.mac_ver()[0]}")
print(f"处理器架构: {platform.processor()}")

保存后在终端运行：

python3 check_python.py

脚本将输出完整的Python版本、安装路径、macOS版本号和处理器架构信息。

常见问题与注意事项

1. 不要删除系统自带的Python 2

macOS的某些系统工具和脚本依赖Python 2运行。如果删除了系统自带的Python 2，可能会导致部分系统功能异常。保留它，同时使用python3命令来运行新安装的Python 3即可。

2. 始终使用python3和pip3命令

在macOS终端中，建议始终使用python3和pip3命令，这样可以避免与系统预装的Python 2产生命令冲突。

3. Homebrew安装的优势

通过Homebrew安装的Python更容易进行版本升级和依赖管理。如果你是一名经常使用Python的开发者，推荐优先选择Homebrew安装方式。

4. 安装Xcode命令行工具

部分Python第三方包在安装时需要编译C扩展，因此需要系统具备编译工具。建议提前安装Xcode命令行工具：

xcode-select --install

5. Apple Silicon芯片的兼容性

对于搭载M1/M2/M3芯片的Mac，大部分Python第三方库已经提供了arm64架构的原生支持。如果遇到不兼容的情况，可以通过Rosetta 2转译运行Intel版本的Python。

6. 权限问题处理

如果在安装过程中遇到权限相关的错误提示，可以使用sudo命令提升权限，但请注意，使用sudo时需要谨慎，确保你了解命令的作用。

两种安装方式对比总结

动手练习

python3 --version
pip3 --version
which python3