怎么使用VS Code快速新建并运行Python脚本

图 0：VS Code 快速新建与运行 Python 脚本界面全景

一、准备工作：确认环境与安装必备扩展

VS Code 本质上是一款轻量级代码编辑器，自身并不内置 Python 解释器。要在其中顺畅运行 Python 脚本，需要确保计算机系统和编辑器内两项前置组件就绪：

1. 系统安装 Python 解释器：在电脑操作系统中已安装 Python（建议 Python 3.8 及以上）。可以通过系统命令行输入 python --version 或 python3 --version 进行验证。如果能正常输出版本号，说明系统环境已就绪。
2. 安装 VS Code 官方 Python 扩展：打开 VS Code，点击左侧活动栏的扩展图标（快捷键 Ctrl+Shift+X，macOS 为 Cmd+Shift+X），在搜索框输入 Python，认准发布者为 Microsoft 的插件点击“安装”。该扩展为编辑器注入了代码高亮、智能补全、环境检测以及一键运行按钮等核心功能。

图 1：从新建脚本到终端输出的 4 个关键操作节点

二、快速新建 Python 脚本文件

新建 Python 脚本有两种常用方式。对于单个临时测试脚本，可以直接新建单文件；对于后续需要管理多个模块或数据的任务，推荐使用“打开文件夹”方式。

方式 1：打开项目文件夹（推荐工作流）

点击 VS Code 菜单栏的 文件 > 打开文件夹（或按快捷键 Ctrl+K Ctrl+O，macOS 为 Cmd+O），选择或新建一个专门的工作目录（例如 my_python_project）。

文件夹载入后，在左侧“资源管理器”侧边栏空白处右键，或点击目录名右侧的“新建文件”图标，输入文件名（例如 main.py）后回车确认。

方式 2：极速单文件新建

如果不打算建立项目目录，只需按下快捷键 Ctrl+N（macOS 为 Cmd+N）创建一个空白文档。

三、选择与核对 Python 解释器

当打开任何一个 .py 文件时，VS Code 会自动在底层检测系统中可用的 Python 解释器。查看与切换解释器的方法如下：

• 查看状态栏：观察 VS Code 界面最下方的状态栏右下角（或部分版本界面的左下角），会看到类似 Python 3.11.x 的文字标识。
• 手动切换解释器：如果显示“选择解释器”或者希望切换到其他虚拟环境，可以按下组合键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）调出命令面板，输入并选择 Python: Select Interpreter。此时顶部下拉列表中会列出检测到的所有全局环境、Conda 环境和本地虚拟环境（.venv），点击即可完成关联。

图 2：VS Code 解释器检测与脚本执行绑定机制

四、编写第一段测试脚本

在新建好的 main.py 编辑区域中，输入以下验证代码。这段代码不仅能够检验打印输出，还能直观打印出当前脚本所使用的 Python 解释器路径与版本：

import sys
import os

# 定义测试变量与问候语
user_name = "VS Code Python 开发者"
print(f"你好，{user_name}！")

# 打印当前执行环境的具体信息
print(f"当前 Python 版本: {sys.version.split()[0]}")
print(f"脚本运行工作目录: {os.getcwd()}")

代码编写完成后，按 Ctrl+S（macOS 为 Cmd+S）保存。如果标签页上的文件名右侧带有实心白点，表示内容尚未保存，请务必保存后再进行下一步。

五、运行 Python 脚本的 3 种实用方式

在 VS Code 中运行 Python 脚本有三种主流方式，适用于不同的开发阶段与场景需求：

图 3：三种运行方式的执行机制与适用场景对比

1. 点击右上角“运行”按钮（最直观、推荐日常使用）

在代码编辑器的右上角，会有一个实心三角播放图标（鼠标悬停会显示 “运行 Python 文件” / “Run Python File”）。直接单击该图标，VS Code 会在下方自动呼出集成终端（Terminal），并自动在终端中拼接解释器路径与当前脚本文件的完整路径进行执行。

2. 在集成终端中显式执行命令（适合带参数调试）

如果需要向脚本传递命令行参数，或者习惯使用命令行交互：

1. 按快捷键 Ctrl + `（反引号，位于键盘 Esc 键下方）打开集成终端。
2. 在终端命令行输入运行命令并按回车：

# Windows / macOS / Linux 常用命令示例
python main.py
# 若系统默认 python 指向 python2，则使用 python3
python3 main.py

3. 选中代码交互式执行（Shift + Enter，分段试跑利器）

在编写算法或分析数据时，如果不想每次都从头运行整个文件，可用鼠标拖动选中需要运行的某几行代码，然后按下 Shift + Enter。VS Code 会启动一个交互式 Python 终端（REPL），只执行选中的代码行，并将变量和运行状态保留在内存中，供后续代码继续调用。

六、结果验证与输出观察

点击运行后，VS Code 下方的集成终端面板会自动弹出。终端中首先会打印出一串激活环境及执行命令的系统语句，随后紧接着输出脚本内的打印结果。以本教程的示例脚本为例，终端的典型输出如下：

> 终端示例输出内容（说明：路径根据个人系统会有所不同）：
你好，VS Code Python 开发者！
当前 Python 版本: 3.11.8
脚本运行工作目录: /Users/work/my_python_project

当终端光标重新变回复位状态（出现提示符如 $ 或路径提示）时，说明脚本已顺利执行完毕并正常退出。

七、常见故障排查与速查清单

在初次新建和运行 Python 脚本时，读者最常遇到的三个问题及其应对策略如下：

图 4：常见故障排查自检树与高频快捷键速查

1. 右上角没有出现运行三角图标

这通常有两个原因：一是文件扩展名未正确命名为 .py（例如存成了无后缀文件或 .txt）；二是安装了 Python 扩展但尚未被激活。解决方法是检查并重命名文件后缀，并在左侧扩展面板中确认 Microsoft 出品的“Python”插件显示为“已启用”。

2. 提示 ModuleNotFoundError: No module named 'xxx'

如果明明在系统中使用 pip install 安装了三方库，但在 VS Code 运行脚本时依然报错找不到模块，根本原因是解释器环境不匹配。VS Code 右下角选中的 Python 环境与安装依赖的环境不一致。点击右下角状态栏切换至安装了该依赖的 Python 解释器，或者直接在 VS Code 当前打开的集成终端中再次运行 pip install xxx 即可。

3. 修改了代码后运行，输出依然是旧内容

VS Code 默认不会在执行运行命令前强制自动保存文件。如果标签页上的文件名右侧有一个小圆点，说明代码改动仅存在于内存中。按下 Ctrl+S 保存后再点运行，或进入 文件 > 首选项 > 设置，搜索 files.autoSave，将其设置为 afterDelay 或 onFocusChange，让编辑器自动保存。