安装 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
打开浏览器,进入 VS Code 官方下载页。网址是 code.visualstudio.com。
在页面的 Windows 一栏找到 User Installer (x64)。有时需要先展开“Other Downloads”。点击后,等待下载完成。
下载的文件名以 VSCodeUserSetup 开头,以 .exe 结尾。可以按浏览器里的 Ctrl+J 打开下载记录,找到它后点击打开。
安装窗口里怎么选
- 在许可协议页面选择 I accept the agreement(我接受协议),点击 Next(下一步)。
- 安装位置和开始菜单文件夹都保留默认值,继续点击 Next。
- 到 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)
- 找到 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code,发布者应为 Microsoft。
- 点击 Install(安装)。
- 安装后,点击提示中的 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
- 关闭 PowerShell,重新从“开始”菜单打开,再运行一次命令。安装前打开的窗口可能还不知道新软件的位置。
- 如果仍提示 py 不被识别,试着输入
python --version。若能看到 Python 3.13 的版本号,说明 Python 已装好,需要再检查启动器。 - 如果 python 命令也找不到,或打开了 Microsoft Store,回到安装步骤,检查是否用的是指定的 .exe 安装程序。重新打开安装程序后,可以选择 Modify,确认 py launcher 已勾选。
还不能解决时,把你输入的命令和下面出现的完整文字发给我,先把安装问题查清楚。
建一个放代码的文件夹
回到桌面,在空白处点击鼠标右键,选择新建 → 文件夹,命名为 python-course。本课程练习文件都放在这里。
关闭 VS Code,再重新打开一次,让它读到刚安装的 Python。
- 在 VS Code 中点击文件 → 打开文件夹。
- 找到“桌面”,选中
python-course,点击“选择文件夹”。 - 如果询问是否信任此文件夹,确认是自己刚建的 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 文件仍需在电脑的终端中运行。
合上教程,重新打开 VS Code,找到 python-course 中的 hello.py,再运行一次。能独立完成这次操作,就说明软件已经可以正常使用。
下次学习前,用自己的话回答两个问题:代码保存在哪里?输入哪条命令可以运行它?忘记时可以查看安装速查表。