VS Code 安装 Python 扩展后怎么运行第一个脚本

在 VS Code 中安装官方 Python 扩展之后，运行第一个脚本的核心路径非常清晰：先确认计算机本身已安装好 Python 解释器，接着在 VS Code 中打开一个工作文件夹，新建一个以 .py 结尾的文件并编写代码，然后在状态栏指定正确的 Python 解释器，最后点击编辑器右上角的“运行”按钮或在集成终端中执行命令查看结果。掌握这一过程的关键在于明确“VS Code 只是代码编辑与交互界面，它必须绑定系统中实际存在的 Python 解释器才能执行程序”。

一、运行前确认：本地计算机是否已安装 Python 解释器

许多刚接触编程的读者容易产生误解，以为在 VS Code 的“扩展（Extensions）”商店里点击安装了 Microsoft 的 Python 插件，电脑就可以运行 Python 脚本了。实际上，该扩展只负责提供代码智能提示、语法检查以及调度调试器，并不自带 Python 运行时环境。

在开始操作前，请先验证本地是否已安装 Python：

1. 使用快捷键 Ctrl + `（反引号）打开 VS Code 底部集成终端（macOS 同样为 Ctrl + `）。
2. 在终端命令行中输入以下命令并回车：

python --version

如果当前使用的是 macOS 或部分 Linux 发行版，则需要输入：

python3 --version

如果终端返回了具体的版本信息（如 Python 3.11.8），说明 Python 解释器已就绪。如果提示“'python' 不是内部或外部命令”或“command not found”，说明系统尚未安装 Python，或者未将 Python 安装路径添加到系统环境变量（PATH）中。此时需要前往 Python 官方网站（python.org）下载安装包安装，并在 Windows 安装向导的第一步务必勾选 Add python.exe to PATH。

二、核心操作步骤：从新建文件到执行运行

确认系统具备 Python 解释器后，按照以下规范步骤即可顺利完成第一次运行。

1. 打开专用工作文件夹

建议初学者不要直接使用菜单中的“新建文件”草稿模式。直接新建的文件没有归属目录，VS Code 无法持久化记录工作区解释器配置与相对路径。正确的做法是：

• 在电脑硬盘中先创建一个空文件夹（例如 D:\learn_python 或 ~/projects/learn_python）。
• 在 VS Code 顶部菜单栏依次点击 文件（File） → 打开文件夹（Open Folder），选中刚刚创建的文件夹。
• VS Code 重新载入后，左侧的“资源管理器”视图中就会呈现出该文件夹名称。

2. 新建并编写第一个 Python 脚本

在左侧资源管理器中，点击文件夹名称旁边的“新建文件”图标（或在空白处右键点击“新建文件”），输入文件名：

hello.py

打开该文件，输入一段简洁的基础代码：

# hello.py
message = "这是在 VS Code 中运行的第一个 Python 脚本"
print("Hello, VS Code!")
print(message)

输入完成后，按快捷键 Ctrl + S（macOS 为 Cmd + S）保存文件。

3. 选择或切换 Python 解释器

安装 Python 扩展后，编辑器右下角（或底部状态栏左侧）通常会显示当前绑定的 Python 版本（如 Python 3.11.x 64-bit）。

如果底部没有显示，或者显示为 Select Interpreter，需要手动指定一次：

1. 按快捷键 Ctrl + Shift + P（macOS 为 Cmd + Shift + P）调出顶部命令面板。
2. 在输入框中键入 Python: Select Interpreter 并按回车。
3. 在下拉列表中，VS Code 会列出在当前操作系统中检测到的全部 Python 环境（包括全局环境、Conda 环境或虚拟环境）。点击选用推荐的那个 Python 版本即可。

三、运行脚本的常见方式

在 VS Code 中，运行当前打开的 Python 文件通常有三种途径，读者可以根据操作习惯选择。

方式一：点击右上角的三角形“运行”按钮（最直观）

这是安装 Python 官方扩展后最便捷的运行方式：

1. 确保当前处于 hello.py 的代码编辑界面。
2. 查看编辑器右上角，可以看到一个朝右的三角形播放图标（鼠标悬停会显示 Run Python File）。
3. 点击该图标，VS Code 会自动在界面下方调出“终端（Terminal）”面板，并自动拼接并运行解释器命令。

方式二：在代码编辑区通过右键菜单运行

在编辑区代码任意位置点击鼠标右键，在弹出的上下文菜单中找到并点击 在终端中运行 Python 文件（Run Python File in Terminal）。该操作的底层效果与点击右上角按钮完全一致。

方式三：在集成终端中直接输入命令

如果希望像在真实项目环境中那样灵活传参或熟悉底层执行逻辑，可以直接在集成终端中输入命令：

python hello.py

如果在 macOS 或 Linux 上，默认别名未映射时输入：

python3 hello.py

验证执行结果

无论采用上述哪种方式，只要配置正常，底部的终端面板中都会清晰输出如下内容：

# 终端执行示例
Hello, VS Code!
这是在 VS Code 中运行的第一个 Python 脚本

当看到这两行文本打印在终端窗口中时，即证明第一个 Python 脚本已经顺利执行完成。

四、常见初学者问题排查与解决办法

在首次配置和运行过程中，如果未能看到预期的输出，通常可以根据错误表现按照以下路径逐步定位排查。

1. 报错提示“无法将‘python’项识别为 cmdlet、函数、脚本文件或可运行程序”

这是 Windows 用户最常遇到的问题。产生该现象的原因是：在安装 Python 运行时，没有把 Python 的安装目录与 Scripts 目录写入系统的 PATH 环境变量；或者在安装完 Python 之后，没有彻底重启 VS Code，导致编辑器继承的仍是安装前的旧环境变量。

解决方法：

• 彻底关闭 VS Code 所有窗口并重新打开。
• 如果依然报错，可在 Windows 搜索栏中搜索“环境变量”，打开“编辑系统环境变量”，在“系统变量”中的 Path 项目里，确认是否存在形如 C:\Users\用户名\AppData\Local\Programs\Python\Python311 的路径。若不存在，手动添加进去。

2. 底部提示“Select Interpreter”且无法自动找到解释器

当系统里安装了多个绿色版 Python，或者通过非标准路径安装时，VS Code 扩展可能无法自动通过注册表检索到解释器。

解决方法：按快捷键 Ctrl + Shift + P，输入 Python: Select Interpreter，在出现的第一项中选择 Enter interpreter path...（输入解释器路径），点击 Find...（浏览），直接找到硬盘中 python.exe 所在的确切路径即可。

3. 终端打印的中文字符显示为乱码或问号

该现象通常出现在 Windows 平台上的命令提示符（CMD）或部分版本的 PowerShell 中。Windows 简体中文默认代码页为 936（GBK），而 Python 3 默认输出使用的是 UTF-8 编码，编码不一致时就会显示为乱码。

解决方法：在 VS Code 底部集成终端中直接输入以下命令并按回车：

chcp 65001

此命令会将当前终端的活动代码页切换为 UTF-8。之后再次运行 Python 脚本，中文即可正常显示。

4. 混淆了“输出（Output）”与“终端（Terminal）”面板

部分新手点击右上角运行按钮后，发现底部的“输出（Output）”标签里什么都没有，误以为程序没有运行。注意：VS Code 的官方 Python 扩展默认是在 终端（Terminal） 标签页中拉起 Shell 进程并打印结果的，请确保底部面板激活的标签页为“终端”而非“输出”或“调试控制台”。

五、总结

在 VS Code 中成功运行第一个 Python 脚本的关键，在于理顺“本地解释器”与“VS Code 编辑界面”之间的衔接机制。只要确保计算机已安装 Python 并加入环境变量、在 VS Code 中以“打开文件夹”方式组织项目、为文件指定正确的解释器，便能通过右上角的运行按钮或集成终端一键获得执行结果。建立起这套标准的操作流程后，后续引入虚拟环境管理、包安装或断点调试也会变得十分顺畅。