开始在 Windows 上使用 Python（初学者）

项目
2025-04-17

对于有兴趣使用 Windows 学习 Python 的初学者，我们建议在以下两个设置路径之间进行选择：

使用 winget 配置文件设置 Python 开发环境
手动设置 Python 开发环境

使用 WinGet 配置文件设置 Python 开发环境

Winget 配置文件包括安装要求和为特定项目设置计算机所需的所有说明。若要使用 Microsoft 的初学者 Python 项目 WinGet 配置设置文件，请执行以下步骤：

通过打开此链接并选择“原始文件内容 > 下载”（右上方的三个点菜单）： Winget 配置：learn_python.winget 来下载配置文件。
若要运行该文件，请双击下载的配置文件（首次需要选择“Windows 程序包管理器客户端”应用以打开并运行该文件），也可以在 Windows 终端中打开 Powershell 并输入以下命令：
```
winget configure -f <path to learn_python.winget file>
```
文件路径将如下所示 winget configure -f C:\Users\<your-name>\Downloads\learn_python.winget。
配置文件开始运行后，你将看到终端窗口中列出的设置步骤，包括将要安装的项目要求。然后，需要确认已查看这些配置更新，并确认希望继续选择 [Y] 是或 [N] 否。
一旦您继续，项目所需的组件将会被安装，并报告配置是否已成功应用。

计算机现已设置为学习 Python！

若要确认，请通过输入以下命令 python --version，检查计算机上安装了哪个版本的 Python。

手动设置 Python 开发环境

若要手动设置 Python 开发环境，而不是使用 winget 配置文件，需要：

安装 Python
安装 Visual Studio Code
安装适用于 Python 的 Visual Studio Code 扩展

安装 Python：有多个版本的 Python 可供安装（基于一段时间内对编码语言进行的更新）。首先需要确定所需的 Python 版本。您可以参考 Python 版本状态 | Python 开发人员指南中当前支持的版本。我们建议使用现代且受支持的版本，或者匹配你计划参与的那个 Python 项目的版本。在本教程中，建议使用 Microsoft Store 安装 Python。

使用 Microsoft Store 安装 Python 3 - 选择可用的最新版本，然后选择“下载”。通过 Microsoft 应用商店安装 Python 会使用 Python 3 并处理当前用户的 PATH 设置（避免管理员访问权限需求），并提供自动更新。 Python 完成下载和安装过程后，在 Windows 终端中打开 PowerShell 并输入以下命令： python --version 确认计算机上安装的 Python 版本。

如果在 Windows 上将 Python 用于 Web 开发，则建议为开发环境设置其他设置。建议通过适用于 Linux 的 Windows 子系统安装和使用 Python，而不是直接在 Windows 上安装。

开始在 Windows 上使用 Python 进行 Web 开发。

如果你有兴趣在作系统上自动执行常见任务，请参阅我们的指南：

开始使用 Windows 上的 Python 编写脚本和自动化。

对于某些高级方案（例如需要访问/修改 Python 已安装的文件、创建二进制文件的副本或直接使用 Python DLL），可能需要考虑直接从 python.org 下载特定的 Python 版本或安装替代项，例如 Anaconda、Jython、PyPy、WinPython、IronPython 等。仅当你是具有选择替代实现的特定原因的更高级 Python 程序员时，我们才建议这样做。

安装 Visual Studio Code：Visual Studio Code 是代码编辑工具，有时称为集成开发环境或 IDE。 Visual Studio Code 提供 GitHub Copilot （提供编码建议的 AI 支持工具）、 IntelliSense （代码完成助手）、 Linting （有助于避免在代码中出错）、调试支持（有助于在运行代码后查找代码中的错误）、代码片段（用于小型可重用代码块的模板）和单元测试（使用不同类型的输入测试代码接口）。

在 Windows 上安装 Visual Studio Code

安装适用于 Python 的 Visual Studio Code 扩展：Visual Studio Code 提供“扩展”，允许你添加支持功能，这些功能 可扩展 对正在使用的任何语言或工具的支持。在此情况下，Python 扩展为代码格式设置、IntelliSense 代码补全建议、调试、Lint 分析、重构等功能添加了特定于 Python 的支持。

从 Visual Studio Code Marketplace 安装 Python 扩展

有关一些 Python 基础知识的 Hello World 教程

据创建者 Guido van Rossum 所说，Python 是一种“高级编程语言”，其核心设计理念全都与代码可读性以及使程序员可以采用几行代码来表达概念的语法相关。

Python 是一种解释型语言。与所编写的代码需要转换为机器码才能由计算机处理器运行的编译型语言不同，Python 代码直接传递给解释器并直接运行。只需键入代码并运行即可。我们来试一试！

打开 PowerShell 命令行后，输入 python 以运行 Python 3 解释器。（某些说明倾向于使用命令 py 或 python3，这些命令也有效）。你会知道已成功执行，因为会显示一个 >>> 提示符（包含三个大于符号）。
可以通过几种内置方法修改 Python 中的字符串。使用以下命令创建变量：variable = 'Hello World!'。按 Enter 以换行。
使用以下命令打印变量：print(variable)。这会显示文本“Hello World!”。
使用以下命令算出字符串变量的长度（使用的字符数）：len(variable)。这会显示使用了 12 个字符。（请注意，空格在总长度中计为一个字符。）
将字符串变量转换为大写字母：variable.upper()。现在将字符串变量转换为小写字母：variable.lower()。
统计在字符串变量中使用字母“l”的次数：variable.count("l")。
在字符串变量中搜索特定字符，我们使用以下命令来查找感叹号：variable.find("!")。这会显示感叹号是在字符串中的第 11 位字符。
将感叹号替换为问号：variable.replace("!", "?")。
若要退出 Python，可以输入 exit()、quit() 或选择 Ctrl-Z。

此教程的 PowerShell 屏幕截图

希望你在使用 Python 的某些内置字符串修改方法时感受到乐趣。现在，请尝试创建 Python 程序文件并使用 Visual Studio Code 运行它。

将 Python 与 VS Code 一起使用的 Hello World 教程

VS Code 团队结合了一个出色的 Python 入门教程，其中演练了如何使用 Python 创建 Hello World 程序、运行程序文件、配置和运行调试器以及安装 matplotlib 和 numpy 等包以在虚拟环境中创建图表。

若要运行 Python 代码，必须告知 VS Code 要使用哪个解释器。由于已安装 Python 扩展，因此可以通过打开 命令面板 （Ctrl+Shift+P）选择 Python 解释器，开始键入命令 Python：选择要搜索的解释器 ，然后选择命令。在可用时，还可以使用底部状态栏上的“选择 Python 环境”选项（它可能已显示所选解释器）。该命令提供可用解释器的列表，包括虚拟环境。只需选择列表中的第一个，除非有其他所需解释器的原因，请参阅 “配置 Python 环境”。

在 VS Code 中选择 Python 解释器

选择解释器后，让我们尝试将其与 VS Code 内置终端一起使用：

若要在 VS Code 中打开终端，请选择视图>终端，或者使用快捷方式 Ctrl+`（使用反撇号字符）。默认命令行环境是 PowerShell。
在 VS Code 终端中，只需通过输入以下命令即可打开 Python：python
通过输入以下内容来尝试使用 Python 解释器：print("Hello World")。 Python 会返回语句“Hello World”。
在终端中，创建一个名为“hello”的空文件夹，导航到此文件夹，然后使用以下代码在 VS Code 中打开该文件夹：
```
mkdir hello
cd hello
code .
```
VS Code 打开后，在左侧 资源管理器 窗口中会显示新的 hello 文件夹，在 VS Code 的底部面板中，您可以通过按下 Ctrl+`（使用反引号）或选择视图>终端来打开命令行窗口。在一个文件夹中启动 VS Code 会使该文件夹成为“工作区”。 VS Code 将特定于该工作区的设置存储在 .vscode/settings.json 中，这些设置与全局存储的用户设置分隔开来。
继续 VS Code 文档中的教程：创建 Python Hello World 源代码文件。

什么是 PIP？

包管理器是一种工具，可自动执行安装、升级、配置和删除软件包的过程。 Python 的生态系统丰富，Python 包索引（PyPI）上提供了数千个包。 Pip 是 Python 附带的标准包管理器程序。通过 pip 可以安装和管理不属于 Python 标准库的其他包。要确认还可使用 pip 来安装和管理包，请输入 pip --version

若要使用 pip 安装包，可以使用以下命令：

pip install <package_name>

尝试将 <package_name> 替换为 https://pypi.org/ 中的包的名称。例如，可以使用以下命令尝试安装 pip 升级： pip install --upgrade pip

pip 的优势之一是能够创建一个 requirements.txt 文件，该文件列出了项目的所有依赖项。此文件可用于在另一台计算机上复制环境。使用命令 pip freeze > requirements.txt 创建一个文件，该文件将列出当前开发环境中的所有已安装包及其版本。若要运行此要求文件以设置具有相同环境的新计算机，需要运行 pip install -r requirements.txt。

使用 Pygame 创建简单游戏

Pygame 运行示例游戏

Pygame 是一种用于编写游戏的常用 Python 包 - 鼓励学生学习编程，同时创建有趣的内容。 Pygame 会在新窗口中显示图形，因此无法在 WSL 的纯命令行方法下工作。但是，如果按照本教程中所述通过 Microsoft Store 安装了 Python，则它会正常工作。

安装 Python 后，通过键入 python -m pip install -U pygame --user 从命令行（或 VS Code 中的终端）安装 pygame。
通过运行示例游戏来测试安装：python -m pygame.examples.aliens
一切正常，游戏会打开一个窗口。玩完游戏后，关闭该窗口。

下面介绍如何开始编写自己的游戏。

打开 PowerShell（或 Windows 命令提示符）并创建名为“bounce”的空文件夹。导航到此文件夹并创建名为“bounce.py”的文件。在 VS Code 中打开该文件夹：
```
mkdir bounce
cd bounce
new-item bounce.py
code .
```

使用 VS Code 输入以下 Python 代码（或是复制并粘贴）：

import sys, pygame

pygame.init()

size = width, height = 640, 480
dx = 1
dy = 1
x= 163
y = 120
black = (0,0,0)
white = (255,255,255)

screen = pygame.display.set_mode(size)

while 1:

    for event in pygame.event.get():
        if event.type == pygame.QUIT: sys.exit()

    x += dx
    y += dy

    if x < 0 or x > width:   
        dx = -dx

    if y < 0 or y > height:
        dy = -dy

    screen.fill(black)

    pygame.draw.circle(screen, white, (x,y), 8)

    pygame.display.flip()

将它保存为：bounce.py。
在 PowerShell 终端中，通过输入以下内容来运行它：python bounce.py。

尝试调整某些数字，以查看它们对弹力球的影响。

可在 pygame.org 上阅读有关使用 pygame 编写游戏的更多信息。

继续学习的资源

建议通过以下资源来支持你继续了解 Windows 上的 Python 开发。

Microsoft 开发人员博客：Python：阅读 Microsoft 中所有 Python 相关内容的最新更新。

在 VS Code 中使用 Python

在 VS Code 中编辑 Python：深入了解如何通过 VS Code 的自动完成和 IntelliSense 功能来更好地利用 Python，包括如何自定义其行为，或者只是简单地关闭它们。
Linting Python：Linting 是运行程序的过程，会分析代码以查找潜在错误。了解 VS Code 为 Python 提供的不同形式的 linting 支持，以及如何进行设置。
调试 Python：调试是在计算机程序中识别并消除错误的过程。本文介绍如何使用 VS Code 初始化和配置 Python 的调试、如何设置和验证断点、如何附加本地脚本、如何针对不同应用类型或在远程计算机上执行调试以及一些基本的故障排除。
对Python 进行单元测试：介绍了一些说明单元测试含义的背景、一个示例演练、如何启用测试框架、如何创建和运行测试、如何调试测试以及测试配置设置。

通过