Python 开发环境

安装 Python 是你在电脑上编写和运行 Python 代码的第一步。

本章将引导你完成在 Windows、macOS 和 Linux 操作系统上的安装全过程，确保你拥有一个随时可以为后续学习提供支持的 Python 运行环境。我们将涵盖如何下载正确的安装包、使用正确的设置运行安装程序，以及如何验证 Python 是否已成功安装。

1. 在 Windows 上安装 Python

1.1 第一步：下载 Python 安装程序

1. 打开浏览器，访问 Python 官方下载页面：https://www.python.org/downloads/windows/
2. 选择最新版本的 Python 3。通常建议使用最新的稳定版。寻找类似“Download Python 3.x.x”的按钮或链接。请避开 Python 2.x.x 版本，因为它们已经过时且不再受官方支持。
3. 选择适合你系统的安装程序。通常你需要为 64 位系统选择“Windows installer (64-bit)”，或者为 32 位系统选择“Windows installer (32-bit)”。如果你不确定该选哪个，可以在电脑的设置中查找你的系统类型（搜索“系统信息”）。

1.2 第二步：运行安装程序

1. 找到下载的安装包（通常在你的“下载”文件夹中），双击运行。
2. 极其重要：勾选“Add Python 3.x to PATH”复选框。 将 Python 添加到系统的 PATH 环境变量中，可以让你直接在命令行（或 PowerShell）中运行 Python，而无需输入 Python 执行文件的完整路径。
3. 点击“Install Now” (立即安装)，使用默认设置开始安装。如果你想自行控制安装路径和可选功能，也可以选择“Customize installation” (自定义安装)。如果你选择了“自定义安装”，你可以勾选可选功能，如 pip（Python 的包管理器）和 tcl/tk（用于 GUI 界面开发）。通常建议保留所有可选功能的勾选状态。你也可以在这里更改安装路径，但默认路径通常就足够了。
4. 等待安装完成。这可能需要几分钟时间。
5. 解除路径长度限制 (Disable path length limit)。安装完成后，你可能会看到这个选项。建议点击它。这会移除 Windows 系统对路径长度 260 个字符的限制，能有效避免未来在使用某些 Python 包时出现报错。

1.3 第三步：在 Windows 上验证安装

1. 打开命令提示符 (CMD) 或 PowerShell。你可以在 Windows 搜索栏中搜索“cmd”或“PowerShell”。
2. 输入以下命令并按回车键：
• python --version
• 这个命令会显示你安装的 Python 版本号，例如：Python 3.x.x。
3. 输入以下命令并按回车键：
• pip --version
• 这个命令会显示 pip 的版本。pip 是 Python 的包管理工具，专门用来安装和管理外部的第三方代码库。
4. 验证结果：如果你看到了 Python 和 pip 的版本号，说明安装成功！如果你收到报错信息，很可能是因为在安装时没有勾选将其添加到 PATH。遇到这种情况，你需要重新安装 Python，并确保勾选了“Add Python 3.x to PATH”。或者，你也可以手动将 Python 添加到 PATH 环境变量中（可以在网上搜索具体的操作步骤）。

2. 在 macOS 上安装 Python

2.1 第一步：下载 Python 安装程序

1. 打开浏览器，访问 Python 官方下载页面：https://www.python.org/downloads/macos/
2. 选择最新版本的 Python 3。寻找类似“Download Python 3.x.x”的按钮或链接。
3. 下载 macOS 安装包。这通常是一个 .pkg 格式的文件。

2.2 第二步：运行安装程序

1. 找到下载的安装包（通常在“下载”文件夹中），双击运行。
2. 按照屏幕上的指示操作。安装向导会引导你完成流程。你需要同意许可协议并选择安装位置（默认位置即可）。
3. 等待安装完成。这可能需要几分钟。

2.3 第三步：在 macOS 上验证安装

macOS 系统通常会自带一个预装的 Python 2 版本。但是，我们要确保使用的是刚刚安装的 Python 3。

1. 打开终端 (Terminal)。你可以在 /应用程序/实用工具/终端.app 中找到它。
2. 输入以下命令并按回车键：
1. python3 --version
2. 这会显示你安装的 Python 3 的版本号，例如：Python 3.x.x。
3. 输入以下命令并按回车键：
1. pip3 --version
2. 这会显示与 Python 3 关联的 pip 版本。
4. 验证结果：如果你看到了 Python 3 和 pip3 的版本号，说明安装成功！如果出现错误，可能是 Python 3 没有正确添加到 PATH 中。这时你需要手动编辑 .bash_profile 或 .zshrc 文件来添加环境变量。

3. 在 Linux 上安装 Python

Linux 上的安装过程因你使用的发行版（如 Ubuntu、Fedora、Debian 等）而异。不过，绝大多数发行版都可以通过系统自带的包管理器直接安装 Python 3。

3.1 第一步：使用包管理器安装

1. 打开终端 (Terminal)。
2. 更新你的软件包列表。这能确保你获取到最新的可用软件包信息。具体命令取决于你的发行版：
1. Ubuntu / Debian：sudo apt update
2. Fedora：sudo dnf update
3. Arch Linux：sudo pacman -Syu
3. 安装 Python 3。同样，命令取决于你的发行版：
1. Ubuntu / Debian：sudo apt install python3 python3-pip
2. Fedora：sudo dnf install python3 python3-pip
3. Arch Linux：sudo pacman -S python python-pip
4. 当系统提示时，输入你的管理员密码。
5. 等待安装自动完成。

3.2 第二步：在 Linux 上验证安装

1. 打开终端。
2. 输入以下命令并按回车键：
• python3 --version
• 终端应返回版本号，例如：Python 3.x.x。
3. 输入以下命令并按回车键：
• pip3 --version
• 终端应返回 pip 的版本信息。
4. 验证结果：如果两者的版本号都正常显示，恭喜你，安装成功！

4. 常见问题与排查

• 提示 "python" 命令未找到 (command not found)：这通常意味着 Python 没有被加入到你的 PATH 环境变量中。在 Windows 上，请确认你安装时勾选了“Add Python to PATH”；在 macOS 或 Linux 上，请检查你的终端配置文件（如 .bashrc 或 .zshrc）是否正确配置了 PATH。
• 权限错误 (Permission errors)：在 Linux 和 macOS 上，当你使用 pip 安装全局包时可能会遇到权限报错。你可以尝试使用管理员权限安装包：

sudo pip3 install <包的名称>

Python 版本冲突：如果你电脑上安装了多个 Python 版本，请确保你调用的是正确的那个。在命令行中使用 python3 和 pip3 可以明确指定你使用的是 Python 3 环境。