目录

1. 第一步：下载 Python 安装包
2. 第二步：安装 Python (关键步骤)
3. 第三步：验证安装
4. 第四步：配置环境变量 (高级但推荐)
5. 第五步：选择和使用代码编辑器
6. 第六步：使用包管理器 pip
7. 第七步：创建和管理虚拟环境 (最佳实践)
8. 第八步：总结与常见问题

第一步：下载 Python 安装包

1. 访问官网：打开浏览器，访问 Python 官方下载页面： https://www.python.org/downloads/windows/

2. 选择版本：

   • 页面会自动检测你的 Windows 系统（32位或64位），并推荐最新的稳定版。强烈推荐下载最新稳定版，Python 3.12.x。
   • 如果你需要特定旧版本,可以点击 "View the full list of downloads" 查找。

3. 下载安装程序：

   • 点击 "Download Python 3.x.x" 按钮，下载的是一个名为 python-3.x.x-amd64.exe (64位) 或 python-3.x.x.exe (32位) 的文件。

第二步：安装 Python (最关键的一步)

千万不要直接双击运行！ 右键点击下载的 .exe 文件，选择 “以管理员身份运行”，这可以避免一些权限问题。

在安装向导的界面中,请务必注意以下两个核心选项：

1. Install Now (标准安装)

   • 这是最简单的选项,它会自动将 Python 安装到系统默认路径（如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python3x），并自动配置好环境变量。
   • 适合绝大多数初学者，如果你不确定，就选这个。

2. Customize installation (自定义安装) - 强烈推荐

   • 点击这个选项可以让你进行更精细的控制,特别是 环境变量 的配置。

在自定义安装的界面中,请勾选以下两个非常重要的选项：

• Add Python to PATH

  • 这是最重要的选项！ 勾选它后，系统会自动将 Python 的可执行文件路径添加到系统的 PATH 环境变量中。
  • 为什么重要？ 如果不勾选，你将无法在命令行（CMD 或 PowerShell）中直接使用 python 命令，每次运行 Python 脚本都需要输入完整的文件路径，非常麻烦。
  • 如果忘记勾选了怎么办？ 别担心，我们后面会手动配置。

• Install for all users

  • 勾选后,Python 会被安装到公共程序目录（如 C:\Program Files\Python3x），所有用户账户都可以使用。
  • 如果不勾选,Python 只会安装在当前用户目录下，其他用户无法访问。

建议操作：选择 Customize installation，然后确保 Add Python to PATH 和 Install for all users 都被勾选，然后点击 "Next" 完成安装。

第三步：验证安装

安装完成后,我们需要验证 Python 是否正确安装并配置。

1. 打开命令提示符：

   • 按 Win + R 键，输入 cmd，然后按回车。
   • 或者,在开始菜单搜索 "cmd" 或 "PowerShell"。

2. 检查 Python 版本： 在命令行窗口中输入以下命令：

   python --version

   或者

   python -V

   如果安装成功,你会看到类似 Python 3.12.0 的输出，如果提示 'python' 不是内部或外部命令...，说明环境变量没有配置好，请跳到第四步。

3. 检查 pip 版本： pip 是 Python 的包管理器，通常随 Python 一起安装，输入以下命令：

   pip --version

   同样,如果看到版本信息，说明 pip 也配置好了。

第四步：配置环境变量 (如果忘记勾选 Add Python to PATH)

如果在安装时忘记勾选 Add Python to PATH，或者安装后想修改路径，可以手动配置。

1. 找到 Python 安装路径：

   • 如果你使用了 Install Now，路径通常在 C:\Users\你的用户名\AppData\Local\Programs\Python\Python3x。
   • 如果你使用了 Customize installation 并勾选了 Install for all users，路径通常在 C:\Program Files\Python3x。
   • 进入该文件夹,你会看到 python.exe 和 Scripts 文件夹。

2. 打开系统环境变量设置：

   • 按 Win + R，输入 sysdm.cpl，回车。
   • 在弹出的“系统属性”窗口中，点击“高级”选项卡，然后点击“环境变量”按钮。

3. 编辑 Path 变量：

   • 在“系统变量”（或“用户变量”）列表中，找到名为 Path 的变量，选中它，然后点击“编辑”。
   • 在“编辑环境变量”窗口中，点击“新建”，然后依次添加以下两个路径（请根据你的实际安装路径修改）：
     • C:\Program Files\Python312 (或者你的 Python 安装根目录)
     • C:\Program Files\Python312\Scripts (存放 pip 等工具的目录)
   • 点击“确定”保存所有更改。

4. 重新验证： 关闭所有命令行窗口，重新打开一个新的 cmd 或 PowerShell，然后再次运行 python --version 和 pip --version 命令，现在应该就能正常工作了。

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

虽然可以用记事本写 Python 代码，但强烈推荐使用专业的代码编辑器，它们提供语法高亮、自动补全、错误提示等功能，能极大地提升开发效率。

• Visual Studio Code (VS Code) - 强烈推荐

  • 特点：免费、轻量、功能强大，拥有庞大的插件生态。
  • 安装：从 https://code.visualstudio.com/ 下载并安装。
  • 配置：
    1. 安装 VS Code 后，打开它。
    2. 在左侧扩展栏（图标像积木）搜索并安装 Python 插件（由 Microsoft 发布）。
    3. 安装后,VS Code 会自动检测到你安装的 Python 环境。

• PyCharm

  • 特点：专为 Python 打造的 IDE，功能非常全面，适合大型项目开发。
  • 版本：提供免费的社区版（Community）和付费的专业版（Professional），初学者使用社区版完全足够。

第六步：使用包管理器 pip

pip 是 Python 的官方包安装工具，你可以用它来安装第三方库（比如用于数据分析的 pandas，用于网站开发的 Django 等）。

1. 安装库：

   # 安装一个库，requests
   pip install requests

2. 卸载库：

   pip uninstall requests

3. 查看已安装的库：

   pip list

4. 升级库：

   pip install --upgrade requests

重要提示：有时你可能会看到 pip 和 pip3 命令，在 Windows 上，如果你正确配置了 PATH，两者通常指向同一个程序，但在 Linux/macOS 上，pip 可能对应 Python 2，pip3 对应 Python 3，在 Windows 上，统一使用 pip 即可。

第七步：创建和管理虚拟环境 (最佳实践)

为什么需要虚拟环境？ 想象一下，你正在开发项目 A，它需要 requests 库的 2.25 版本，你又在开发项目 B，它需要 requests 库的 2.30 版本，如果都安装在同一个全局环境中，就会产生冲突。

虚拟环境可以为每个项目创建一个独立、干净的 Python 环境，避免库版本冲突。

1. 创建虚拟环境： 在你的项目文件夹下（D:\MyProject），打开命令行，然后运行：

   # my-project-env 是你给虚拟环境起的名字
   python -m venv my-project-env

   执行后,你的项目文件夹下会出现一个名为 my-project-env 的新文件夹。

2. 激活虚拟环境： 在命令行中，进入虚拟环境的 Scripts 文件夹，然后运行激活脚本。

   cd my-project-env\Scripts
   activate

   激活成功后,你的命令行提示符前面会出现 (my-project-env) 的字样，表示你当前在这个虚拟环境中。

3. 在虚拟环境中安装库： 现在用 pip 安装的库，只会安装到这个虚拟环境里，不会影响全局环境。

   (my-project-env) D:\MyProject\my-project-env\Scripts> pip install numpy

4. 退出虚拟环境： 当你完成工作后，只需输入以下命令即可退出：

   deactivate

VS Code 中的虚拟环境： VS Code 非常智能，当你打开一个包含 venv 文件夹的项目时，它会自动检测并提示你选择要使用的解释器，点击右下角的解释器名称，可以选择 my-project-env 中的 Python，VS Code 就会自动激活这个环境。

第八步：总结与常见问题

一个标准的工作流程

1. 安装：从官网下载 Python，安装时务必勾选 Add Python to PATH。
2. 验证：在 CMD 中运行 python --version 确认安装成功。
3. 创建项目：新建一个文件夹作为你的项目根目录。
4. 创建虚拟环境：在项目根目录下打开 CMD，运行 python -m venv venv。
5. 激活环境：运行 venv\Scripts\activate。
6. 写代码：用 VS Code 或 PyCharm 打开项目文件夹，开始编写 .py 文件。
7. 安装依赖：在激活的环境中，用 pip install <库名> 安装所需库。
8. 运行代码：在 VS Code 中点击运行按钮，或在 CMD 中用 python <文件名>.py 运行。

常见问题 (FAQ)

• Q: 安装时提示 "Access is denied" (拒绝访问)。

  • A: 右键安装包，选择 “以管理员身份运行”。

• Q: 运行 pip install 时报错 Could not find a version that satisfies the requirement ... 或 ERROR: Could not build wheels for ...。

  • A1: 尝试升级 pip：python -m pip install --upgrade pip。
  • A2: 某些库需要编译，可能缺少 C++ 编译器，可以尝试安装 Microsoft C++ Build Tools，或者使用预编译的二进制包（如 wheel）。

• Q: 我有两个 Python 版本（3.8 和 3.10），如何让 pip 安装到指定的版本？

  • A: 使用 python 命令会激活默认版本，如果你想指定，可以直接使用 python3.10 -m pip install <库名>。

• Q: 在 VS Code 中运行代码，提示 "No such file or directory: 'python'"。

  • A: 这是因为 VS Code 没有正确选择 Python 解释器，点击右下角的解释器名称，在弹出的列表中选择你安装的 Python 路径即可，如果列表里没有，可以点击 "在 PATH 中查找..."。