目录

1. 为什么需要安装 Python？
2. 在 macOS 上安装 Python 的几种方式
3. 使用 Homebrew（推荐）
   • 什么是 Homebrew？
   • 步骤 1: 安装 Homebrew
   • 步骤 2: 使用 Homebrew 安装 Python
   • 步骤 3: 验证安装
4. 从官网下载安装包
   • 步骤 1: 下载官方安装包
   • 步骤 2: 运行安装程序
   • 步骤 3: 验证安装
5. 使用 Python 官方安装器 (pyenv)
   • 什么是 pyenv？
   • 步骤 1: 安装 pyenv
   • 步骤 2: 安装 Python 版本
   • 步骤 3: 切换 Python 版本
6. 如何选择安装方式？
7. 安装后的重要配置：设置环境变量
   • 问题：zsh: command not found: python3
   • 解决方案：配置 PATH 环境变量
8. 安装 Python 包管理工具 pip 和虚拟环境工具 venv
9. 推荐的开发环境配置
   • 代码编辑器：Visual Studio Code
   • 终端：iTerm2
10. 总结与最佳实践

为什么需要安装 Python？

macOS 系统自带一个 Python 版本（通常是 Python 2.7），但这个版本非常老旧，不应用于开发，你需要安装一个最新的 Python 3 版本,因为：

• Python 2 已停止支持：官方不再维护，存在安全漏洞,也没有新功能。
• Python 3 是未来：它是当前和未来的标准,拥有更现代的语法和更强大的库。
• 学习和发展：绝大多数最新的教程、书籍和项目都基于 Python 3。

在 macOS 上安装 Python 的几种方式

主要有三种主流方式,各有优劣：

方式一：使用 Homebrew（强烈推荐）

Homebrew 是 macOS 下的包管理器,能让你轻松安装各种开源软件。

步骤 1: 安装 Homebrew

如果你已经安装了 Homebrew,可以跳过这一步。

1. 打开 终端（Terminal），你可以在 应用程序 -> 实用工具 里找到它，或者使用 Spotlight 搜索（Command + 空格键，输入 Terminal）。

   
   （图片来源网络，侵删）

2. 在终端中，复制并粘贴以下命令，然后按回车，这个命令会从官方源下载并安装 Homebrew。

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

3. 安装过程中会提示你输入你的电脑密码，输入时屏幕上不会有任何显示，这是正常的,输完后按回车即可。

4. 安装完成后，Homebrew 会提示你将 Homebrew 添加到 PATH，根据你的终端提示,执行相应的命令。

   • 对于 Apple Silicon (M1/M2/M3) Mac，它会提示你运行：

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

   • 对于 Intel Mac，它会提示你运行：

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

   提示：现在的新版 macOS 默认使用 zsh 作为默认 Shell，所以配置文件是 ~/.zshrc，如果你还在使用 bash，则应修改 ~/.bash_profile。

步骤 2: 使用 Homebrew 安装 Python

Homebrew 安装成功后，安装 Python 就非常简单了,在终端中输入以下命令：

brew install python

Homebrew 会自动下载并安装最新的稳定版 Python 3，这个过程可能需要几分钟,取决于你的网络速度。

步骤 3: 验证安装

安装完成后，我们需要验证 Python 和 pip（Python 的包管理器）是否正确安装。

1. 检查 Python 版本：

   python3 --version

   你应该会看到类似 Python 3.x.x 的输出，x.x 是具体的版本号。

2. 检查 pip 版本：

   pip3 --version

   你会看到 pip 的版本信息和它关联的 Python 路径。

重要提示：在 macOS 上，为了避免与系统自带的旧版 Python 冲突，新安装的 Python 命令通常为 python3 和 pip3，虽然你可以创建别名让 python 直接指向 python3，但初期建议使用 python3 和 pip3 以免混淆。

方式二：从官网下载安装包

如果你不想使用命令行,这种方式最适合你。

步骤 1: 下载官方安装包

1. 访问 Python 官方下载页面：https://www.python.org/downloads/
2. 页面会自动检测你的操作系统并推荐最新的稳定版，点击 "Download Python x.x.x"` 按钮。
3. 浏览器会开始下载一个 .pkg 文件。

步骤 2: 运行安装程序

1. 找到下载好的 .pkg 文件,双击打开它。

2. 按照安装向导的提示一步步操作，在安装过程中，非常重要的一步是：

   • 在 "Installation Type" 界面，确保点击 "Install command line tools for Xcode" 选项，这会安装 pip 和其他开发工具。
   • 同样，在 "Customize installation" 界面，确保勾选了 "Install pip` 和 "Install tcl/tk and IDLE`。

3. 输入你的电脑密码以允许安装程序更改系统。

4. 等待安装完成。

步骤 3: 验证安装

与 Homebrew 方式一样，打开终端,输入以下命令进行验证：

python3 --version
pip3 --version

如果看到版本号,说明安装成功。

方式三：使用 Python 官方安装器

这种方式适合需要管理多个 Python 版本的开发者。

步骤 1: 安装 pyenv

你需要安装 Homebrew（如果还没有的话），然后通过 Homebrew 安装 pyenv。

brew install pyenv

安装完成后，需要将 pyenv 初始化命令添加到你的 Shell 配置文件中（以 zsh 为例）。

echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

然后重启你的终端，或者运行 source ~/.zshrc 使配置生效。

步骤 2: 安装 Python 版本

现在你可以使用 pyenv 安装任何你想要的 Python 版本，安装最新的 Python 3.11：

pyenv install 3.11.5

pyenv 会从源码编译安装,这个过程可能需要较长时间。

步骤 3: 切换 Python 版本

安装完成后，你可以为当前用户或整个项目设置 Python 版本。

1. 为当前用户设置全局 Python 版本：

   pyenv global 3.11.5

2. 为当前目录设置 Python 版本（局部）：

   pyenv local 3.11.5

   这会在当前目录下创建一个 .python-version 文件，每次你进入这个目录时，pyenv 会自动切换到这个 Python 版本。

验证安装：

python --version
# 现在直接使用 python 命令即可，它会指向 pyenv 管理的版本

如何选择安装方式？

• 如果你是初学者：直接选择 方式一（Homebrew），这是最省心、最符合社区习惯的选择。
• 如果你只想快速用一下，不想碰命令行：选择 方式二（官网安装包）。
• 如果你是经验丰富的开发者，或者你的项目需要在不同 Python 版本间切换：学习并使用 方式三（pyenv）,它会给你带来极大的灵活性。

安装后的重要配置：设置环境变量

你在终端输入 python3 或 pip3 会提示 command not found，这通常是因为系统的 PATH 环境变量没有正确配置。

问题原因： macOS Catalina (10.15) 之后，默认的 Shell 从 bash 改为了 zsh，新用户的配置文件是 ~/.zshrc，而旧用户的可能是 ~/.bash_profile 或 ~/.bashrc，如果你之前配置过,可能配置在了错误的文件里。

解决方案：

1. 打开终端，输入以下命令，打开 zsh 的配置文件（如果文件不存在，它会自动创建）：

   open -e ~/.zshrc

2. 在打开的文本编辑器中,在文件最上方添加以下两行：

   # Python 3 from Homebrew
   export PATH="/usr/local/opt/python/libexec/bin:$PATH"

   注意：

   • 如果你使用的是 Apple Silicon Mac (M1/M2/M3)，请使用：

     export PATH="/opt/homebrew/opt/python/libexec/bin:$PATH"

   • 如果你使用的是 官网安装包，Python 通常安装在 /usr/local/bin，这一步可能不需要,但加上也无妨。

3. 保存并关闭文本编辑器。

4. 在终端中,运行以下命令让配置立即生效：

   source ~/.zshrc

5. 再次尝试 python3 --version 和 pip3 --version,应该就能正常工作了。

安装 Python 包管理工具 pip 和虚拟环境工具 venv

通过 Homebrew 或官网安装包安装的 Python，通常会自带 pip 和 venv,你只需要验证一下。

• pip：用于安装第三方库。

  pip3 install requests

• venv：用于创建虚拟环境。强烈建议在每一个新项目中都使用虚拟环境，它可以隔离项目依赖,避免版本冲突。

  # 1. 创建一个名为 'my_project_env' 的虚拟环境
  python3 -m venv my_project_env
  # 2. 激活虚拟环境
  source my_project_env/bin/activate
  # 3. 激活后，你的终端提示符前会出现 (my_project_env)
  # 现在使用 pip 安装的包都会被隔离在这个环境里
  pip install numpy
  # 4. 完成工作后，退出虚拟环境
  deactivate

推荐的开发环境配置

• 代码编辑器：Visual Studio Code (VS Code)

  • 免费、强大、轻量，拥有海量的 Python 插件。
  • 必装插件：
    • Python：由 Microsoft 官方提供，提供代码补全、调试、Linting 等功能。
    • Pylance：Python 语言服务器,提供更智能的代码分析。
    • Jupyter：支持在 VS Code 中直接打开和运行 .ipynb 文件。

• 终端：iTerm2

  macOS 自带的终端功能已经很强大，但 iTerm2 提供了更多自定义选项、分屏、标签页等功能,能极大提升你的命令行操作效率。

总结与最佳实践

1. 首选安装方式：对于绝大多数 macOS 用户，使用 Homebrew 安装 Python 是最佳实践。
2. 使用 python3 和 pip3：为了避免与系统旧版 Python 冲突，请始终使用 python3 和 pip3 命令。
3. 配置 PATH：如果遇到命令找不到的问题，检查并配置好 ~/.zshrc 文件中的 PATH。
4. 拥抱虚拟环境：养成在项目中使用 venv 创建虚拟环境的好习惯,这是专业开发的标志。
5. 选择趁手的工具：配置一个像 VS Code + iTerm2 这样的现代化开发环境,能让你的编程之旅事半功倍。

祝你编程愉快！