快速搞定 Windows 安装 Python (新手必看) – wiki基地

作者： /

快速搞定 Windows 安装 Python (新手必看)

引言：踏上 Python 之旅的第一步

欢迎来到充满无限可能的编程世界！如果您选择 Python 作为您的起点，恭喜您，这是一个非常明智的选择。Python 以其简洁的语法、强大的功能和活跃的社区，成为了当今最受欢迎的编程语言之一，广泛应用于 Web 开发、数据科学、人工智能、自动化脚本等众多领域。

对于编程新手来说，安装开发环境往往是入门的第一道坎。尤其是对于 Windows 用户，有时会遇到各种各样的问题，让人感到困惑和挫败。但请放心，通过本篇超详细的指南，您将能够轻松、快速地在您的 Windows 电脑上成功安装 Python，为您的编程学习之路打下坚实的基础。

本文将从零开始，一步步引导您完成 Python 的下载、安装、配置，并告诉您如何验证安装是否成功，甚至包括一些常见问题的解决方法。请您耐心跟随每一个步骤，即使您是完全没有编程经验的小白，也能顺利完成！

第一部分：准备工作——安装前你需要知道什么？

在正式开始安装之前，了解一些基础知识和做好准备是很有必要的。这能帮助您在安装过程中做出正确的选择，并避免一些常见的坑。

  1. 你的操作系统：Windows
    本文专门针对 Windows 操作系统。无论是 Windows 10、Windows 11，还是较旧的 Windows 7/8，基本的安装流程都大同小异，但界面可能会略有差异。请确保您的 Windows 系统能够正常运行。

  2. Python 的版本选择：面向未来的 Python 3
    Python 主要有两个大版本系列：Python 2 和 Python 3。请务必选择 Python 3！ Python 2 已经在 2020 年停止官方支持，意味着它不会再有安全更新和新功能。目前绝大多数新的 Python 项目和库都只支持 Python 3。对于新手来说，直接学习和使用 Python 3 是最佳选择。
    在 Python 3 的各个小版本中（如 3.9, 3.10, 3.11, 3.12 等），通常建议选择最新的稳定版本。新版本通常包含性能优化、新特性和错误修复。不过，如果您的学习资料或项目有特定版本要求，那么请遵循其要求。对于绝大多数新手而言，直接下载官网上推荐的最新版本即可。

  3. 32 位还是 64 位？适配你的 Windows 系统
    Python 安装程序分为 32 位（x86）和 64 位（x86-64）。您需要根据您的 Windows 操作系统是 32 位还是 64 位来选择对应的安装程序。

    • 如何查看你的 Windows 是 32 位还是 64 位？
      • 在 Windows 10/11 中：右键点击“此电脑”（或“我的电脑”），选择“属性”。在弹出的窗口中，查找“系统类型”。它会显示“64 位操作系统”或“32 位操作系统”。
      • 在较旧的 Windows 版本中：类似地，右键点击“我的电脑”，选择“属性”，在“系统”部分查找。
    • 选择建议： 如果您的系统是 64 位，强烈建议安装 64 位的 Python，因为它可以更好地利用您系统的内存和处理器性能。如果您的系统是 32 位，那么您只能安装 32 位的 Python。

  4. 管理员权限（可选但建议）：
    虽然标准用户通常也可以安装 Python，但有时安装过程中需要写入系统文件或注册表。如果您拥有管理员权限，安装过程会更加顺畅，遇到权限问题的概率会降低。如果您是在自己家里的电脑上安装，通常您就是管理员。如果您是在公司或学校的电脑上安装，可能需要联系管理员。

  5. 稳定的网络连接：
    下载 Python 安装文件需要网络，安装过程中也可能需要下载一些组件。请确保您有稳定可用的网络连接。

第二部分：获取 Python 安装程序——官方渠道最可靠

获取 Python 安装程序的最佳途径是访问 Python 的官方网站：python.org。从官方网站下载可以确保您获得的是安全、完整且最新的安装文件。

  1. 打开浏览器，访问 python.org
    在您的浏览器地址栏输入 https://www.python.org/ 并回车。

  2. 导航到下载页面
    将鼠标悬停在官网顶部的菜单栏中的 “Downloads”（下载）选项上。这时会弹出一个下拉菜单。

    • 如果您看到推荐的最新版本 Python for Windows，直接点击它即可跳转到下载页面或直接开始下载。
    • 如果您想查看更多版本或手动选择，可以点击 “All releases”（所有发布版本）。

  3. 选择并下载适合您的版本

    • 直接点击推荐版本： 如果您直接点击了推荐的最新 Windows 版本，页面会跳转到该版本的下载页面。通常会提供一个醒目的按钮或链接来下载安装程序。
    • 查看所有发布版本： 如果您点击了 “All releases”，您会看到一个列表，列出了 Python 所有的历史版本。找到最新的 Python 3.x.x 版本（例如，撰写本文时可能是 3.12.x 或 3.13.x）。点击该版本号进入其详情页面。
    • 在版本详情页面： 向下滚动，找到 “Files”（文件）部分。这里列出了该版本针对不同操作系统的下载文件。找到适用于 Windows 的部分。
      • 根据您之前确定的系统类型（32 位或 64 位），选择对应的安装文件。文件名称通常包含版本号和位数信息，例如：
        • python-3.x.x-amd64.exe (这是 64 位安装程序，amd64 或 x86-64 都代表 64 位)
        • python-3.x.x.exe (这是 32 位安装程序，如果文件名不包含 amd64 或 x86-64 且在 Windows 32-bit section，它就是 32 位)
      • 点击对应文件的链接，您的浏览器就会开始下载 Python 安装程序。请记住您将文件保存到哪里（通常在“下载”文件夹）。

第三部分：开始安装——最关键的步骤

下载完成后，找到您刚才下载的 .exe 安装文件（文件名类似 python-3.x.x-amd64.exe）。双击运行它。

安装程序启动后，您会看到一个安装向导窗口。请注意这个窗口的第一个界面，它有一个非常关键的选项！

  1. 第一个重要选择：“Add Python to PATH”
    在安装向导的底部，您会看到一个复选框，上面写着：Add python.exe to PATH 或 Add Python 3.x to PATH。
    请务必勾选这个选项！

    • 为什么这个选项如此重要？
      • PATH 是 Windows 系统的一个环境变量。您可以把它想象成一个“程序查找路径列表”。当您在命令提示符（Command Prompt）或 PowerShell 中输入一个命令（例如 python 或 pip）时，Windows 会去 PATH 环境变量指定的目录列表中寻找是否存在对应的可执行文件（如 python.exe）。
      • 如果您不勾选这个选项，Python 虽然会被安装到您的电脑上，但 Windows 不知道 python 这个命令在哪里，您就无法直接在命令行中运行 Python 解释器或使用 pip（Python 的包管理器）。这意味着您每次想运行 Python 程序时，都必须进入 Python 的安装目录去执行 python.exe，这会非常不方便。
      • 勾选了这个选项后， 安装程序会自动帮您把 Python 的安装路径添加到系统的 PATH 环境变量中，这样您就可以在任何位置的命令提示符或 PowerShell 窗口中直接运行 python 和 pip 命令了，极大地提高了使用效率。

  2. 选择安装方式：“Install Now” vs. “Customize installation”
    在勾选了 “Add Python to PATH” 之后，您会看到两个主要的安装选项：

    • Install Now (立即安装): 这是推荐给新手用户的选项。它会使用默认设置进行安装，包括安装到推荐的路径、安装常用的组件（如 pip、IDLE、文档等）。对于绝大多数用户来说，这是最方便快捷的方式。
    • Customize installation (自定义安装): 这个选项允许您更改安装路径、选择要安装的组件等。如果您不确定自己在做什么，不建议选择这个选项。只有当您有特定需求（例如需要安装到非默认路径，或者不想安装某些组件）时才使用自定义安装。

    对于新手，请直接选择并点击 “Install Now” 按钮。 （请确保您已经勾选了 “Add Python to PATH”！）

  3. 安装过程
    点击 “Install Now” 后，安装程序会开始复制文件、配置系统。这个过程可能需要几分钟，取决于您的电脑性能。您会看到一个进度条显示安装进度。请耐心等待，不要关闭窗口。
    在安装过程中，Windows 的用户账户控制 (UAC) 可能会弹出提示，询问是否允许安装程序对您的电脑进行更改。请点击“是”（Yes）以允许安装继续。

  4. 完成安装
    安装完成后，您会看到一个“Setup was successful”（设置成功）的界面。这意味着 Python 已经成功安装到您的电脑上了。
    在这个界面上，您可能会看到一个关于“Disable path length limit”（禁用路径长度限制）的选项。这是一个可选的步骤，通常在您处理包含非常深的目录结构的 Python 项目时才可能用到。对于大多数新手来说，暂时可以忽略它。如果您好奇，点击它通常需要管理员权限，并且它允许 Python 和 pip 处理超过 Windows 默认 260 个字符的路径长度限制。对于初学者，不点它通常也完全没问题。

  5. 关闭安装向导
    点击“Close”（关闭）按钮，退出安装向导。

第四部分：验证安装——检查你的 Python 是否可用

安装完成后，最重要的事情是验证 Python 是否真的安装成功，特别是之前勾选的“Add Python to PATH”选项是否生效。我们将使用 Windows 的命令提示符或 PowerShell 来进行验证。

  1. 打开命令提示符 (Command Prompt) 或 PowerShell

    • 最快的方式： 按下键盘上的 Win 键（Windows 徽标键）+ R 键，打开“运行”对话框。输入 cmd 然后按回车键，即可打开命令提示符。
    • 另一种方式： 在 Windows 搜索栏中输入 cmd 或 PowerShell，然后点击搜索结果中的“命令提示符”或“Windows PowerShell”。
    • 重要提示： 如果您在安装 Python 之前已经打开了命令提示符或 PowerShell 窗口，请将它们关闭，然后重新打开一个新的窗口。这是因为环境变量的更改通常在新的终端窗口中才会生效。

  2. 输入 Python 命令进行验证
    在打开的命令提示符或 PowerShell 窗口中，输入以下命令，然后按回车键：
    bash
    python --version
    或者使用这个命令，效果相同：
    bash
    python -V

  3. 检查输出结果

    • 如果安装成功且 PATH 配置正确： 您应该会看到类似 Python 3.x.x 的输出，显示您刚刚安装的 Python 版本号。例如：
      Python 3.11.5
      或者如果您安装的是 Python 3.12.x，输出就是 Python 3.12.x。
    • 如果命令未找到： 如果您看到类似 'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。 的错误提示，这意味着 Windows 没有在 PATH 环境变量中找到 python.exe。这通常是因为您在安装时没有勾选 “Add Python to PATH” 选项，或者安装后没有关闭并重新打开终端窗口。别担心，我们会在后面的故障排除部分讲解如何解决。

  4. 验证 Pip 是否可用
    Pip 是 Python 的包管理器，用来安装第三方库。现代 Python 版本通常会默认安装 Pip。在同一个命令提示符或 PowerShell 窗口中，输入以下命令并按回车：
    bash
    pip --version

  5. 检查 Pip 输出结果

    • 如果 Pip 可用： 您会看到类似 pip 23.x.x from C:\...\site-packages\pip (python 3.x) 的输出，显示 Pip 的版本以及它关联的 Python 版本。
    • 如果 Pip 命令未找到或报错： 这可能意味着 Pip 没有正确安装或也没有被添加到 PATH 中。同样，这通常伴随着 python 命令未找到的问题，或者是因为安装时出现了某些错误。

第五部分：初探 Python——运行第一个程序

恭喜您！如果前面的验证步骤都成功了，那么您已经在 Windows 上成功安装了 Python 并配置好了环境。现在，让我们来运行一个最简单的 Python 程序，体验一下编程的乐趣。

Python 提供了几种运行代码的方式：交互式解释器、执行 Python 脚本文件。

  1. 使用交互式解释器 (REPL)

    • 继续在您打开的命令提示符或 PowerShell 窗口中，直接输入 python 并按回车。
    • 如果成功，您会看到类似以下的提示符：
      Python 3.x.x (...)
      Type "help", "copyright", "credits" or "license" for more information.
      >>>
      这个 >>> 提示符表示您已经进入了 Python 的交互式解释器环境（REPL – Read-Eval-Print Loop）。您可以在这里逐行输入 Python 代码并立即看到结果。
    • 输入您的第一个 Python 代码：
      python
      print("Hello, World!")
      按下回车键。
    • 您应该会立即看到输出：
      Hello, World!
    • 您还可以尝试一些简单的计算：
      python
      2 + 2
      回车后会输出：
      4
    • 当您想退出交互式解释器时，可以输入 exit() 并回车，或者按下 Ctrl + Z 然后回车。

  2. 运行 Python 脚本文件
    对于更复杂的程序，我们通常会将其保存在一个 .py 后缀的文件中，然后运行这个文件。

    • 创建脚本文件： 打开 Windows 自带的“记事本”（Notepad）或其他任何文本编辑器（如 VS Code, Sublime Text, Notepad++ 等）。
    • 输入以下两行代码：
      python
      print("Hello from a script!")
      print("This is my first Python program.")
    • 保存文件： 点击“文件” -> “保存”。选择一个您容易找到的文件夹，例如您的“文档”文件夹或桌面。将文件名设置为 first_program.py。请务必确保文件后缀是 .py，而不是 .txt。在记事本中保存时，在文件名输入框中输入 "first_program.py"（包含双引号）可以防止它自动加上 .txt 后缀。或者在保存类型中选择“所有文件 (.)”，再输入文件名 first_program.py。
    • 在终端中运行脚本： 回到您的命令提示符或 PowerShell 窗口。您需要先进入到您保存 first_program.py 文件的目录。
      • 使用 cd 命令切换目录。例如，如果您的文件保存在桌面上，您可能需要输入 cd Desktop 然后回车。（请注意，命令和目录名不区分大小写，但为了规范通常使用小写）。
      • 如果您不确定当前目录，可以使用 dir 命令（在 Command Prompt 中）或 ls 命令（在 PowerShell 中）查看当前目录下的文件和文件夹列表。
      • 一旦您切换到了保存 first_program.py 的目录，输入以下命令并按回车：
        bash
        python first_program.py
    • 查看输出： 如果一切顺利，您应该会看到脚本的输出：
      Hello from a script!
      This is my first Python program.
    • 如果报错找不到文件： 这通常是因为您当前所在的目录不对。请使用 cd 命令切换到保存 first_program.py 的确切目录后再运行命令。

通过以上步骤，您不仅成功安装了 Python，还学会了两种基本的运行 Python 代码的方式！

第六部分：故障排除——解决常见问题

即使按照步骤操作，有时也可能会遇到问题。以下是一些新手安装 Python 时最常见的故障及解决方法：

  1. 错误：“’python’ 不是内部或外部命令，也不是可运行的程序或批处理文件。”

    • 原因： 这是最常见的错误，几乎总是因为 Python 的安装路径没有被正确添加到系统的 PATH 环境变量中。
    • 解决方法 1 (推荐): 重新运行安装程序并修改
      • 找到您之前下载的 Python 安装程序 (python-3.x.x-amd64.exe)，双击运行它。
      • 如果 Python 已经安装，安装程序会显示“Modify”（修改）、“Repair”（修复）和“Uninstall”（卸载）选项。
      • 选择 “Modify”。
      • 在下一个界面，确保所有可选功能（特别是 “Add Python to environment variables” 或 “Add Python to PATH” 相关的选项）都被勾选。通常它们会在默认情况下被勾选，但您需要再次确认。
      • 点击“Next”，然后在下一个界面，同样确认与 PATH 相关的选项是勾选的。
      • 点击“Install”或“Modify”让程序重新执行安装/修改过程。
      • 完成后，务必关闭所有已打开的命令提示符或 PowerShell 窗口，然后重新打开一个新的窗口，再次输入 python --version 进行验证。
    • 解决方法 2 (手动添加 PATH，较复杂):
      • 如果您不想重新运行安装程序，可以手动将 Python 的安装路径添加到系统的 PATH 环境变量中。
      • 首先，您需要知道 Python 安装在哪里。如果您使用了“Install Now”，默认路径通常在 C:\Users\YourUserName\AppData\Local\Programs\Python\Python3x 或 C:\Program Files\Python3x (取决于安装时是为当前用户还是所有用户安装)。其中的 YourUserName 是您的 Windows 用户名，Python3x 是您安装的 Python 版本号（如 Python311）。
      • 如何手动编辑 PATH：
        • 在 Windows 搜索栏中输入 环境变量，然后点击“编辑系统环境变量”。
        • 在弹出的“系统属性”窗口中，点击底部的“环境变量”按钮。
        • 在“环境变量”窗口中，找到“系统变量”列表（下半部分）。
        • 找到名为 Path 的变量，选中它，然后点击“编辑”按钮。
        • 在编辑 PATH 变量的窗口中，点击“新建”，然后输入 Python 的安装路径。通常需要添加两个路径：一个是 Python 主程序所在的目录（例如 C:\Users\YourUserName\AppData\Local\Programs\Python\Python311），另一个是其 Scripts 目录（例如 C:\Users\YourUserName\AppData\Local\Programs\Python\Python311\Scripts，Pip 程序通常在这里）。
        • 点击“确定”关闭所有窗口。
        • 务必关闭所有已打开的命令提示符或 PowerShell 窗口，然后重新打开一个新的窗口，再次输入 python --version 进行验证。
      • 注意： 手动编辑 PATH 需要非常小心，错误的修改可能影响系统正常运行。强烈建议新手优先尝试方法 1。

  2. 安装过程报错，提示权限不足

    • 原因： 您当前登录的用户可能没有足够的权限在系统目录或注册表中进行安装。
    • 解决方法： 右键点击 Python 安装程序文件，选择“以管理员身份运行”（Run as administrator），然后再次尝试安装。

  3. 安装过程卡住或失败

    • 原因： 可能由于网络问题、文件损坏、系统资源不足或与其他软件冲突。
    • 解决方法：
      • 检查您的网络连接是否稳定。
      • 重新下载安装程序文件，确保文件完整。
      • 重启电脑后再次尝试安装。
      • 暂时关闭杀毒软件或防火墙（安装完成后请记得重新开启）。
      • 确保您的硬盘有足够的可用空间。

  4. 安装了多个 Python 版本，导致混乱

    • 原因： 您可能之前安装过其他版本的 Python，或者尝试安装时重复运行了安装程序。
    • 现象： 在命令行中输入 python --version 显示的版本不是您期望的版本，或者输入 pip install xxx 时安装到了错误的版本。
    • 解决方法：
      • 检查 PATH 顺序： 当系统中存在多个 python.exe 时，Windows 会按照 PATH 环境变量中列出的目录顺序来查找。先找到哪个就运行哪个。您可以手动编辑 PATH，将您希望默认使用的 Python 版本所在的目录向上移动，使其排在其他 Python 版本目录之前。
      • 使用 py Launcher (推荐，如果已安装): 较新版本的 Python 安装程序会包含一个 py 启动器。您可以使用 py -3 来运行最新的 Python 3 版本，使用 py -3.x 来运行特定小版本的 Python 3。例如 py -3.11 或 py -3.12。这是一种更灵活的方式来管理多个 Python 版本。您可以尝试在命令行输入 py --list 查看已安装的 Python 版本列表。
      • 卸载不需要的版本： 如果您确定不再需要某个旧版本的 Python，可以在 Windows 的“设置” -> “应用” -> “应用和功能”（或旧版控制面板中的“程序和功能”）中找到并卸载它。

  5. Pip 命令可用，但安装库时报错 (SSL Error, Read Timeout等)

    • 原因： 这通常是网络问题，尤其是访问国外资源时速度慢或连接不稳定。
    • 解决方法： 使用国内的 Pip 镜像源。在安装库时，通过 -i 参数指定镜像源，例如使用清华大学的镜像源：
      bash
      pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
      您也可以通过配置让 Pip 永久使用某个镜像源，但这对于初学者来说可能暂时不需要。

第七部分：安装后的下一步——开始你的编程学习！

恭喜您再次！您已经成功安装了 Python 并解决了可能的障碍。现在，您可以真正开始您的 Python 编程之旅了。以下是一些建议的下一步行动：

  1. 选择一个代码编辑器或集成开发环境 (IDE):
    虽然您可以使用记事本编写 Python 代码，但专业的代码编辑器或 IDE 会提供语法高亮、代码补全、调试功能等，极大地提高编程效率和舒适度。

    • 推荐的免费选项：
      • VS Code (Visual Studio Code): 轻量级、功能强大、高度可定制，支持各种语言，拥有丰富的扩展生态系统，是目前最受欢迎的代码编辑器之一。
      • PyCharm Community Edition: 专门为 Python 开发设计的免费 IDE，功能强大，特别适合严肃的 Python 开发。
      • Thonny: 一个为初学者设计的 Python IDE，界面简洁，内置了调试工具，非常适合入门。
        您可以下载并安装其中一个，然后用它来编写和运行您的 Python 代码。

  2. 学习 Python 基础知识：
    安装好环境只是第一步。接下来，您需要学习 Python 的语法、数据类型、控制结构（如循环和条件判断）、函数、模块等基本概念。

    • 学习资源：
      • Python 官方文档： 最权威的资料，但可能对新手不太友好。
      • Codecademy, Coursera, edX, freeCodeCamp 等在线教育平台： 提供结构化的 Python 课程。
      • Bilibili, YouTube 等视频平台： 有大量免费的 Python 教学视频。
      • 各种编程书籍和技术博客。

  3. 了解并使用虚拟环境 (Virtual Environments):
    虽然现在您可以直接安装第三方库到全局 Python 环境中，但在实际开发中，强烈建议使用虚拟环境。虚拟环境可以为每个项目创建一个独立的 Python 环境，这样不同项目可以使用不同版本的库，互相之间不会冲突。这是 Python 开发中的一个最佳实践。

    • Python 3.3+ 内置了 venv 模块来创建虚拟环境。您可以在命令行中使用 python -m venv myenv 命令来创建一个名为 myenv 的虚拟环境。激活和使用虚拟环境的命令会根据您的终端类型（Command Prompt 或 PowerShell）和操作系统有所不同，您可以在学习过程中进一步了解。

  4. 开始动手实践：
    编程是门实践性很强的技能。不要只看不练。从简单的小程序开始，逐步挑战更复杂的项目。解决问题是学习编程最有效的方式。

第八部分：总结

回顾一下我们快速搞定 Windows 安装 Python 的旅程：

  1. 准备工作： 了解版本选择（Python 3）、系统位数（32/64位）和 PATH 的重要性。
  2. 获取安装程序： 从官方网站 python.org 下载适合您系统的最新稳定版安装程序。
  3. 开始安装： 双击运行安装程序，务必勾选 “Add Python to PATH”，然后选择“Install Now”。
  4. 验证安装： 打开新的命令提示符或 PowerShell 窗口，使用 python --version 和 pip --version 命令检查是否成功。
  5. 初探 Python： 学习如何进入交互式解释器，以及如何创建并运行一个简单的 .py 脚本文件。
  6. 故障排除： 了解并掌握解决 PATH 问题、安装失败、多版本冲突等常见错误的方法。
  7. 下一步： 选择合适的代码编辑器/IDE，开始系统学习 Python 基础知识，并积极进行实践。

通过本篇详细的指南，希望您已经成功迈出了学习 Python 的第一步。安装环境仅仅是开始，更精彩的编程世界正等着您去探索。不要害怕遇到问题，解决问题的过程本身也是学习和成长的过程。

祝您在 Python 的学习道路上一帆风顺，享受编程带来的乐趣和成就感！如果您在安装过程中遇到任何本文未提及的问题，可以尝试在搜索引擎中搜索具体的错误信息，或者到 Python 社区、论坛寻求帮助。

现在，去写下你的第一行 Python 代码吧！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部