目录

1. 第一步：下载 Python 安装包
2. 第二步：安装 Python (关键步骤)
3. 第三步：验证安装
4. 第四步：配置环境变量 (如果需要)
5. 第五步：使用虚拟环境 (最佳实践)
6. 第六步：选择和使用代码编辑器
7. 常见问题与解决方案

核心概念

在开始之前，我们先了解几个关键概念,这会让你对整个过程有更清晰的认识：

• Python 解释器: 这是能读懂并执行你写的 Python 代码的程序，我们安装的 Python 就是这个解释器。
• pip: Python 的包管理器，它用来安装、升级、卸载第三方库（numpy, pandas, requests 等），安装 Python 时通常会自动安装 pip。
• 环境变量: 操作系统用来存储可执行程序路径等信息的变量，将 Python 和 pip 的路径添加到环境变量中，你就可以在任何文件夹下直接使用 python 和 pip 命令,而无需输入完整的路径。
• 虚拟环境: 一个独立的、隔离的 Python 环境，它可以为每个项目创建一套独立的依赖库，避免不同项目之间的库版本冲突，这是现代 Python 开发的强烈推荐做法。

第一步：下载 Python 安装包

1. 访问 Python 官方网站：https://www.python.org/downloads/
2. 网站会自动检测你的操作系统并提供最新的稳定版下载，点击 "Download Python X.X.X" 按钮。
   • Windows: 下载一个 .exe 文件。
   • macOS: 下载一个 .pkg 文件。
   • Linux: 大多数 Linux 发行版（如 Ubuntu, Debian）已经预装了 Python，如果没有，或者需要更新，可以使用系统的包管理器安装（sudo apt update && sudo apt install python3）。

第二步：安装 Python (关键步骤)

这一步是整个过程中最容易出错的地方,请务必仔细阅读。

Windows 安装

1. 双击运行你下载的 python-3.x.x-amd64.exe 文件。

2. 重要：勾选 "Add Python X.X to PATH"

   • 这是最关键的一步！勾选这个选项会自动帮你配置环境变量，让你在命令行中可以直接使用 python 和 pip 命令。强烈建议勾选！

3. 点击 "Install Now" 进行标准安装，它会自动将 Python 安装到默认路径,并完成基本配置。

   
   （图片来源网络，侵删）

4. 安装完成后，会弹出提示框，点击 "Close" 即可。

macOS 安装

1. 双击运行你下载的 python-3.x.x.pkg 文件。
2. 按照安装向导的提示一步步操作即可，macOS 的安装程序通常会自动处理好路径问题,所以你不太需要手动配置环境变量。
3. 安装完成后，打开终端（Terminal），输入 python3 --version 来验证是否安装成功，注意，在 macOS 上，为了避免系统自带的 Python 2.x 冲突，通常使用 python3 命令来调用新安装的 Python。

Linux (以 Ubuntu/Debian 为例) 安装

对于大多数现代 Linux 发行版，推荐使用 apt 包管理器进行安装,这样可以更好地与系统集成。

1. 打开终端。
2. 更新软件包列表：

   sudo apt update

3. 安装 Python 3：

   sudo apt install python3

4. pip 通常会作为依赖一起安装，如果没有，可以单独安装：

   sudo apt install python3-pip

第三步：验证安装

安装完成后，我们需要验证 Python 和 pip 是否可以正常使用。

1. 打开命令行工具:

   
   （图片来源网络，侵删）
   • Windows: 按 Win + R，输入 cmd 或 powershell,然后按回车。
   • macOS: 在“应用程序” -> “实用工具”中找到“终端”（Terminal）。
   • Linux: 通常直接按 Ctrl + Alt + T 打开终端。

2. 检查 Python 版本:

   • Windows: 如果你在安装时勾选了 "Add Python to PATH"，输入：

     python --version

     或者

     python -V

   • macOS / Linux: 输入：

     python3 --version

     如果返回类似 Python 3.11.4 的信息，说明 Python 安装成功。

3. 检查 pip 版本:

   • Windows: 输入：

     pip --version

   • macOS / Linux: 输入：

     pip3 --version

     如果返回 pip 的版本和位置信息，说明 pip 也安装好了。

第四步：配置环境变量 (如果需要)

如果你在第二步中没有勾选 "Add Python to PATH"，或者在使用过程中发现 python 或 pip 命令无法识别,就需要手动配置环境变量。

Windows 环境变量配置

1. 在 Windows 搜索栏中搜索“编辑系统环境变量”,并打开它。
2. 在弹出的“系统属性”窗口中，点击“环境变量...”按钮。
3. 在“系统变量”（或“用户变量”）部分，找到名为 Path 的变量，选中它，然后点击“编辑...”。
4. 在“编辑环境变量”窗口中，点击“新建”。
5. 添加 Python 的安装路径和 Scripts 文件夹路径。
   • Python 路径通常是：C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX (XX 是你的版本号)
   • Scripts 路径通常是：C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX\Scripts
   • 请根据你实际的安装路径进行修改！
6. 添加完成后，一路点击“确定”保存设置。然后重新打开一个新的命令行窗口，再运行 python --version 进行测试。

第五步：使用虚拟环境 (最佳实践)

为了避免项目之间的库冲突,强烈建议为每个项目创建一个独立的虚拟环境。

1. 创建项目文件夹: 在你的电脑上创建一个用于存放代码的文件夹，my_project。

2. 进入项目文件夹: 在命令行中，使用 cd 命令进入你的项目文件夹。

   cd path\to\my_project  # Windows
   cd /path/to/my_project  # macOS/Linux

3. 创建虚拟环境: 在项目文件夹内，运行以下命令，我们通常将虚拟环境命名为 venv。

   • Windows:

     python -m venv venv

   • macOS/Linux:

     python3 -m venv venv

     执行后，你的项目文件夹里会出现一个名为 venv 的新文件夹,这就是虚拟环境的家。

4. 激活虚拟环境: 激活后，你命令行的提示符前面会出现 (venv) 字样,表示你当前在这个虚拟环境中。

   • Windows (CMD):

     venv\Scripts\activate

   • Windows (PowerShell):

     .\venv\Scripts\Activate.ps1

     (如果遇到执行策略问题，可能需要先运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process)

   • macOS/Linux:

     source venv/bin/activate

5. 在虚拟环境中工作:

   • 当你使用 pip install 安装的任何库，都会被安装到这个 venv 环境中，而不会影响你的全局 Python 环境。
   • pip install requests numpy

6. 退出虚拟环境: 当你完成工作后,只需输入以下命令即可退出。

   deactivate

第六步：选择和使用代码编辑器

一个好的代码编辑器能极大地提高你的编程效率，对于初学者,推荐以下两款：

1. Visual Studio Code (VS Code):

   • 简介: 免费、开源、功能极其强大的代码编辑器,拥有庞大的插件生态。
   • 安装: 前往 https://code.visualstudio.com/ 下载并安装。
   • 配置:
     • 安装官方推荐的 Python 扩展 (由 Microsoft 发布)。
     • 安装后，VS Code 会自动检测到你系统中的 Python 解释器，你可以在右下角选择解释器，最好选择你刚才创建的虚拟环境中的 python.exe。
     • 现在你可以新建一个 .py 文件，开始写代码并点击右上角的“运行”按钮或按 F5 来运行你的程序了。

2. PyCharm Community Edition:

   • 简介: 专门为 Python 开发的集成开发环境，功能非常全面,对初学者非常友好。
   • 安装: 前往 https://www.jetbrains.com/pycharm/download/ 下载免费的社区版。
   • 配置:
     • 创建新项目时，PyCharm 会引导你选择一个解释器，你可以选择系统自带的 Python，或者选择你创建的虚拟环境中的 Python 解释器。
     • 它内置了运行、调试、代码提示、版本控制等所有你需要的功能。

第七步：常见问题与解决方案

• 问题: 'python' is not recognized as an internal or external command...

  • 原因: Windows 环境变量未配置正确。
  • 解决: 回到 第四步，检查 Path 变量是否正确添加了 Python 和 Scripts 的路径。

• 问题: pip 不是内部或外部命令...

  • 原因: 同上，Scripts 文件夹路径未添加到环境变量。
  • 解决: 同上，检查 Path 变量。

• 问题: macOS/Linux 提示 zsh: command not found: python

  • 原因: 系统默认使用 python3，但你输入的是 python，macOS Catalina 之后，默认 Shell 从 bash 改为了 zsh，它默认不包含 python 命令。
  • 解决: 使用 python3 和 pip3 命令，或者，如果你想用 python 命令，可以创建一个软链接（不推荐新手操作）。

• 问题: 安装库时出现权限错误 (Permission denied)

  • 原因: 尝试在全局 Python 环境中安装库,而当前用户没有管理员权限。
  • 解决 (推荐): 使用虚拟环境，在激活的虚拟环境中，你拥有完全的权限。不要使用 sudo pip install (在 macOS/Linux 上)，这可能会导致系统 Python 环境混乱。

恭喜！现在你已经成功安装了 Python，配置好了环境，并学会了如何使用虚拟环境和代码编辑器，你已经准备好开始你的 Python 学习之旅了！