目录

1. 第一步：下载 Python 安装包
2. 第二步：安装 Python（关键步骤）
3. 第三步：验证 Python 是否安装成功
4. 第四步：配置环境变量（可选，但强烈推荐）
5. 第五步：选择并安装一个代码编辑器（VS Code）
6. 第六步：使用 VS Code 编写并运行你的第一个 Python 程序
7. 常见问题与解决方案

第一步：下载 Python 安装包

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

   
   （图片来源网络，侵删）

2. 选择版本：

   • 页面会自动检测你的系统并提供最新的稳定版下载,对于 Windows 10，通常推荐下载 Python 3.x 版本（Python 3.12.x）。
   • 重要提示：Python 2.x 版本已于 2025 年停止维护，不再推荐用于新项目，请务必选择 Python 3.x。

3. 下载安装包：

   • 你会看到 "Latest Python 3 Release - Python 3.12.x" 的下载按钮。
   • 点击下载,根据你的系统是 64 位还是 32 位，下载的文件名会略有不同（python-3.12.0-amd64.exe 或 python-3.12.0-arm64.exe），绝大多数现代 Windows 10 系统都是 64 位的，下载 amd64 版本即可，如果不确定，可以在“此电脑”的属性中查看。

第二步：安装 Python（关键步骤）

下载完成后,双击运行安装包，这一步有几个极其重要的选项，请务必勾选！

1. Run Python 3.12.0 (64-bit)： 勾选这个选项可以直接运行安装程序，然后进行下一步。

   
   （图片来源网络，侵删）

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

   • 这是最关键的一步！ 勾选这个选项后，安装程序会自动帮你配置好环境变量，这意味着你可以在命令提示符（CMD）或 PowerShell 中直接使用 python 命令，而无需输入完整的安装路径。
   • 强烈建议你勾选此项，可以为你省去后面手动配置环境变量的麻烦。

3. "Install Now"（立即安装）：

   • 点击 "Install Now" 按钮。
   • 安装程序会使用默认设置进行安装,包括将 Python 安装在你的用户目录下（C:\Users\你的用户名\AppData\Local\Programs\Python\Python312），这通常需要管理员权限，它会自动关联 .py 文件。

4. "Disable path length limit"（禁用路径长度限制）：

   • 在安装过程中,可能会弹出一个标题为 "Disable path length limit" 的窗口，这是因为 Windows 默认的路径长度限制为 260 个字符，而 Python 项目很容易超过这个限制。
   • 强烈建议你点击 "Disable path length limit" 按钮，这会修改你的系统注册表，允许更长的文件路径，避免未来可能出现的各种奇怪问题。

5. 完成安装：

   
   （图片来源网络，侵删）

   等待安装进度条完成,然后点击 "Close" 关闭窗口。

第三步：验证 Python 是否安装成功

无论你是否在第二步中勾选了 "Add Python to PATH"，现在都应该验证一下。

1. 打开命令提示符（CMD）或 PowerShell：

   • 在开始菜单中搜索 cmd 或 powershell，然后打开它。

2. 输入验证命令：

   • 在打开的黑色或蓝色窗口中,输入以下命令：

     python --version

     或者

     python -V

3. 检查输出：

   • 如果安装成功且配置了环境变量，你会看到类似以下的输出，显示你安装的 Python 版本号：

     Python 3.12.0

   • 如果提示 'python' 不是内部或外部命令...，说明环境变量没有配置成功，别担心，请跳转到 第四步 进行手动配置。

第四步：配置环境变量（如果上一步失败）

如果你在第三步遇到了错误,说明 Python 的安装路径没有被添加到系统的 PATH 环境变量中，你需要手动添加。

1. 打开“编辑系统环境变量”：

   在开始菜单搜索“编辑系统环境变量”，并打开它。

2. 进入“环境变量”：

   在弹出的“系统属性”窗口中，点击右下角的“环境变量...”按钮。

3. 编辑 Path 变量：

   • 在“系统变量”（或“用户变量”）列表中，找到并选中名为 Path 的变量，然后点击“编辑...”按钮。

4. 添加 Python 路径：

   • 在“编辑环境变量”窗口中，点击“新建”。
   • 将你的 Python 安装路径粘贴进去，路径格式通常是：

     C:\Users\你的用户名\AppData\Local\Programs\Python\Python312

     （请将 你的用户名 和 Python312 替换成你自己的路径，你可以通过在文件资源管理器中进入 Python 安装目录来确认这个路径。）

   • 同样，你还需要添加 Python 的 Scripts 目录，这个目录用于存放 pip 等工具，再点击一次“新建”，并添加以下路径：

     C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts

5. 确认并重启：

   • 连续点击“确定”保存所有更改。
   • 非常重要：关闭所有已打开的命令提示符或 PowerShell 窗口，然后重新打开一个新的，环境变量的更改只在新的进程中生效。

6. 重新验证：

   • 再次在新的 CMD 或 PowerShell 中运行 python --version，现在应该就能成功了。

第五步：选择并安装一个代码编辑器

虽然你可以用记事本写代码,但使用专业的代码编辑器能极大地提升效率和体验，强烈推荐 Visual Studio Code（简称 VS Code），它是免费、强大且广受欢迎的。

1. 下载 VS Code：

   • 访问 VS Code 官网：https://code.visualstudio.com/

2. 安装 VS Code：

   下载后,双击运行安装程序，一路点击 "Next"（下一步）即可，使用默认安装设置即可。

3. 安装 Python 扩展：

   • 打开 VS Code。
   • 点击左侧活动栏的“扩展”图标（四个方块组成的图标）。
   • 在搜索框中输入 Python。
   • 找到由 Microsoft 发布的 Python 扩展，点击“安装”。
   • 这个扩展提供了语法高亮、代码自动补全、智能提示、调试等强大功能。

第六步：使用 VS Code 编写并运行你的第一个 Python 程序

1. 创建项目文件夹：

   • 在你的电脑上创建一个文件夹,D:\MyPythonProject。

2. 在 VS Code 中打开文件夹：

   • 打开 VS Code，然后点击“文件” -> “打开文件夹”，选择你刚刚创建的 MyPythonProject 文件夹。

3. 创建新文件：

   • 在 VS Code 中，点击“文件” -> “新建文件”，或者按 Ctrl + N。

4. 保存文件：

   • 按 Ctrl + S 保存文件，并将其命名为 hello.py。注意后缀名必须是 .py。

5. 编写代码：

   • 在 hello.py 文件中输入以下代码：

     print("Hello, World! 欢迎来到 Python 的世界！")

6. 运行代码：

   • 方法一（推荐）：在代码编辑器窗口中，点击右上角的“运行”按钮（一个三角形图标）。
   • 方法二：按 F5 键启动调试模式（第一次可能会让你选择环境，选择你安装的 Python 即可）。
   • 方法三：在终端中运行，在 VS Code 中点击“终端” -> “新终端”，然后在打开的终端窗口中输入 python hello.py 并按回车。

7. 查看结果：

   • 在 VS Code 窗口下方（或新弹出的终端窗口）中，你应该能看到输出：

     Hello, World! 欢迎来到 Python 的世界！

   • 恭喜！你已经成功安装并运行了你的第一个 Python 程序！

常见问题与解决方案

• Q: 安装时提示 "Access is denied"（访问被拒绝）。

  • A: 这通常是因为你没有管理员权限，右键点击安装包，选择“以管理员身份运行”。

• Q: 运行 pip install 命令时报错。

  • A:
    1. 确保你已经将 Python 的 Scripts 目录添加到了环境变量中（见第四步）。
    2. 尝试使用 python -m pip install 包名 的方式，python -m pip install requests，这种方式可以绕过一些 pip 路径问题。

• Q: VS Code 无法识别 Python 环境，提示 "No Python interpreter selected"。

  • A:
    1. 按 Ctrl + Shift + P 打开命令面板。
    2. 输入并选择 Python: Select Interpreter。
    • 在弹出的列表中,选择你安装的 Python 环境（Python 3.12.32-bit ('python3.12': python3)），如果列表中没有，点击右下角的 "+..." 添加，然后浏览到你的 Python 解释器（通常在 Python安装目录\python.exe）。

• Q: 我应该选择 Python 3.12 还是 Python 3.11？

  • A: 对于新手，始终选择最新的稳定版本（如 3.12），它包含了最新的功能和错误修复，如果你的项目有特殊依赖要求，再考虑使用特定版本。

希望这份详细的教程能帮助你顺利地在 Windows 10 上搭建好 Python 开发环境！祝你编程愉快！