第 1 课 Windows 10 / 11

安装 VS Code 和 Python

这节课从一台还没装过编程软件的电脑开始。先安装两个软件,再写一个文件,运行后让它显示一句话。

操作约需 45–60 分钟,下载时间另计。准备好能联网的电脑,边看边做。

要安装的两个软件

VS Code 用来写代码、保存文件。Python 用来执行你写的代码。它们需要分别下载安装。

“配置环境”指的就是把这些软件装好,让它们能配合工作。本课用 VS Code 编辑文件,用 Python 3.13 运行文件。

下载时遇到 x64、ARM64,怎么选?

在 Windows 的“设置 → 系统 → 系统信息”中查看“系统类型”,有些版本把这一页叫“关于”。

  • 写着“基于 x64 的处理器”:选 x64 或 64-bit。常见的 Intel、AMD 电脑使用这一项。
  • 写着“基于 ARM 的处理器”:选 ARM64。

下面以 x64 电脑为例。ARM 电脑的安装步骤相同,下载时换成 ARM64 安装程序即可。

本课步骤:安装 VS Code、设置中文、安装 Python、检查安装、创建文件夹、安装扩展、运行文件。

下载安装 VS Code

打开浏览器,进入 VS Code 官方下载页。网址是 code.visualstudio.com。

在页面的 Windows 一栏找到 User Installer (x64)。有时需要先展开“Other Downloads”。点击后,等待下载完成。

下载的文件名以 VSCodeUserSetup 开头,以 .exe 结尾。可以按浏览器里的 Ctrl+J 打开下载记录,找到它后点击打开。

安装窗口里怎么选

  1. 在许可协议页面选择 I accept the agreement(我接受协议),点击 Next(下一步)。
  2. 安装位置和开始菜单文件夹都保留默认值,继续点击 Next。
  3. 到 Select Additional Tasks(选择附加任务)页面,勾选下面两项。
选项作用
Create a desktop icon在桌面创建快捷方式,方便下次打开。
Add to PATH让 Windows 能通过命令找到 VS Code;通常已默认勾选。

其他选项保持默认。点击 Next → Install,等待进度条走完。最后保留 Launch Visual Studio Code(启动 VS Code),点击 Finish(完成)。

检查:能看到 VS Code 主窗口,左侧有一列图标,中间可能是欢迎页。第一次打开时出现的主题、登录等介绍可以先关掉。

安装说明:VS Code 官方 Windows 安装文档。

把 VS Code 改成中文

按 Ctrl+Shift+X,左侧会打开扩展页面。“扩展”就是给编辑器增加功能的小工具。

在上方搜索框输入:

Chinese (Simplified)
  1. 找到 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code,发布者应为 Microsoft。
  2. 点击 Install(安装)。
  3. 安装后,点击提示中的 Change Language and Restart(更改语言并重启)。

如果没有出现切换提示,按 Ctrl+Shift+P,输入 Configure Display Language,选中后按回车,再选择 中文(简体) / zh-cn,按提示重启。

检查:窗口重新打开后,上方菜单显示“文件、编辑、选择、查看”等中文文字。

设置说明:VS Code 官方显示语言文档。

下载安装 Python

本课使用 Python 3.13。打开 Python 3.13.17 官方下载页,网址属于 python.org。

向下找到 Files(文件)列表,点击 Windows installer (64-bit)。这是 Windows 安装程序。

下载后的文件名是 python-3.13.17-amd64.exe。这里的 amd64 也适用于 Intel 的 x64 电脑。ARM 电脑请选择列表中的 Windows installer (ARM64)。

如果在列表中看到了 embeddable package、source 等名称,继续找上面指定的 installer;本课用的是安装程序。

先勾选,再安装

双击下载的文件。安装窗口打开后,先看底部的选项:

看到的文字怎么操作
Add python.exe to PATH勾选。这会把 Python 的位置告诉 Windows,之后可以在命令窗口运行它。
Use admin privileges when installing py.exe保持默认设置。这一项与 Python 启动器的安装权限有关。

然后点击 Install Now(立即安装)。安装位置保留默认即可。如果 Windows 弹出“是否允许此应用对你的设备进行更改”,确认是刚打开的 Python 安装程序后,点击“是”。

等待出现 Setup was successful(安装成功),点击 Close(关闭)。如果还看到了 Disable path length limit,本课可以先不处理,直接关闭。

检查:安装窗口明确显示了“Setup was successful”。接下来还要运行一条命令,确认 Windows 找得到它。

安装选项说明:Python 3.13 官方 Windows 安装文档。

检查 Python 是否装好

点击 Windows 的“开始”按钮,搜索 PowerShell,打开 Windows PowerShell。

这个窗口用来输入命令,也叫终端。窗口中可能有一行 PS C:\Users\你的用户名>,光标会在它后面闪动。

在光标处输入下面这一行,按回车:

py -3.13 --version

它的意思是“显示 Python 3.13 的版本号”。py 是安装时附带的 Python 启动器,用来找到并启动 Python。

安装上面这个版本后,结果应为:

Python 3.13.17

看到了版本号,就可以关掉 PowerShell 窗口。如果没有出现,先看下面的排查方法。

提示“py 不被识别”,或者找不到 Python
  1. 关闭 PowerShell,重新从“开始”菜单打开,再运行一次命令。安装前打开的窗口可能还不知道新软件的位置。
  2. 如果仍提示 py 不被识别,试着输入 python --version。若能看到 Python 3.13 的版本号,说明 Python 已装好,需要再检查启动器。
  3. 如果 python 命令也找不到,或打开了 Microsoft Store,回到安装步骤,检查是否用的是指定的 .exe 安装程序。重新打开安装程序后,可以选择 Modify,确认 py launcher 已勾选。

还不能解决时,把你输入的命令和下面出现的完整文字发给我,先把安装问题查清楚。

建一个放代码的文件夹

回到桌面,在空白处点击鼠标右键,选择新建 → 文件夹,命名为 python-course。本课程练习文件都放在这里。

关闭 VS Code,再重新打开一次,让它读到刚安装的 Python。

  1. 在 VS Code 中点击文件 → 打开文件夹。
  2. 找到“桌面”,选中 python-course,点击“选择文件夹”。
  3. 如果询问是否信任此文件夹,确认是自己刚建的 python-course 后,选择“是,我信任此作者”。

检查:左侧文件列表顶部出现 PYTHON-COURSE 或 python-course。此时文件夹还是空的,属于正常情况。

以后写的每个程序,都要保存成文件。“打开文件夹”是告诉 VS Code:这次要处理的文件放在哪里。

安装 Python 扩展,选择解释器

按 Ctrl+Shift+X 打开扩展页面,在搜索框输入:

@id:ms-python.python

找到名为 Python、发布者为 Microsoft 的扩展,点击“安装”。按提示重载窗口即可。

这个扩展让 VS Code 认识 Python 文件、显示代码提示,并提供运行按钮。它和前面安装的 Python 软件各有作用。

接着按 Ctrl+Shift+P,输入:

Python: Select Interpreter

选择这一项并按回车。中文界面可能显示为“Python: 选择解释器”。在随后出现的列表中,选择 Python 3.13.17。

解释器就是实际执行 Python 代码的软件。这里是在告诉 VS Code,运行文件时使用哪个 Python。

列表中没有 Python 3.13?

先重启 VS Code 再查看。如果版本检查已成功,列表仍没有显示,可以打开 PowerShell,运行:

py -3.13 -c "import sys; print(sys.executable)"

它会显示 Python 的完整安装位置。复制显示的路径,再回到“选择解释器”,选择“输入解释器路径”并粘贴。这里暂时只需用这条命令找到路径,代码含义会在后续课程中学习。

操作说明:VS Code 官方 Python 入门。

写一个文件,运行它

按 Ctrl+Shift+E 回到左侧文件列表。把鼠标移到文件夹名称上,点击“新建文件”图标,输入 hello.py,按回车。

.py 是 Python 文件的扩展名。完整文件名是 hello.py,末尾不需要再加 .txt。

在中间的编辑区输入:

print("你好,我的私信助手!")

print 表示显示内容,括号里的文字就是要显示的句子。括号和引号要用英文半角符号:( ) 和 " ";句子本身可以是中文。

按 Ctrl+S 保存文件,再点击上方菜单终端 → 新建终端。如果打开的是其他终端类型,可在终端右上角的下拉菜单中选择 PowerShell。

终端提示的路径末尾应是 \Desktop\python-course>。桌面位置可能不同,但最后的文件夹应为 python-course。

在终端中输入以下命令,按回车:

py -3.13 hello.py

这条命令是让 Python 3.13 运行当前文件夹里的 hello.py。运行后应显示:

你好,我的私信助手!

显示完这句话,下面会重新出现 PS ...>。这表示程序已经执行完,可以输入下一条命令了。

运行时出错,先检查这几处
看到的情况检查方法
can't open file左侧是否有 hello.py?终端是否位于 python-course 文件夹?确认是通过“文件 → 打开文件夹”打开的练习目录,再新建终端。
SyntaxError检查英文括号、英文引号是否成对。改完后按 Ctrl+S,再运行。
输入后出现 >>>你进入了 Python 的交互窗口。输入 exit() 并回车,回到 PS 开头的命令窗口,再输入运行命令。
输出还是改动前的句子文件可能没保存。按 Ctrl+S,再运行一次。

代码说明:Python 官方教程:文本。

课后练习

把 hello.py 中的句子改成 我开始学习 Python 了。,保存并运行。确认终端显示的内容也随之改变。

然后改回原来的句子,再运行一次。把程序显示的那一行粘贴到这里核对:

此处只核对文字。Python 文件仍需在电脑的终端中运行。

Python 解释器的作用是什么?

合上教程,重新打开 VS Code,找到 python-course 中的 hello.py,再运行一次。能独立完成这次操作,就说明软件已经可以正常使用。

下次学习前,用自己的话回答两个问题:代码保存在哪里?输入哪条命令可以运行它?忘记时可以查看安装速查表。