VSCode怎么运行执行python脚本

Felix
Felix
发布时间:2026-11-20| 8人浏览过
原创

本文详解在 Visual Studio Code (VSCode) 中运行与执行 Python 脚本的完整流程,包含前置环境安装、解释器选择、5 种常用运行执行方式、终端结果查看及常见报错排查。

分类:开发工具 / Python 入门教程 阅读时长:约 6 分钟 环境适用:Windows / macOS / Linux
VSCode怎么运行执行python脚本
在 VSCode 中运行 Python 脚本的核心路径清晰且直接:首先确保操作系统已安装 Python 解释器并在 VSCode 中安装微软官方 Python 插件,接着在编辑器底部或命令面板指定要调用的解释器环境,最后通过右上角的运行按钮、右键菜单、快捷键或内置终端命令直接触发执行。

一、前置准备:确保解释器与扩展就绪

Visual Studio Code(简称 VSCode)是一款通用代码编辑器,它本身不附带 Python 解释器。如果直接打开一个 .py 文件而没有完成前置桥接,VSCode 既无法解析语法提示,也找不到可调用的执行程序。运行脚本前,需要依次完成以下三项基础确认:

1. 确认系统已安装 Python

在电脑终端中输入命令核实 Python 是否处于可用状态。对于 Windows 用户,可打开命令提示符或 PowerShell;macOS 与 Linux 用户打开默认终端:

# 检查 Python 版本
python --version
# 在部分 Linux 或 macOS 系统上,默认命令名称可能为 python3
python3 --version

如果控制台正确打印出版本号(例如 Python 3.11.8),说明系统底层已经具备运行能力。如果提示“未找到命令”或不是内部外部命令,需前往 Python 官方网站(python.org)下载安装包安装,并务必勾选“Add python.exe to PATH”。

2. 在 VSCode 中安装 Python 官方扩展

打开 VSCode,点击左侧活动栏的“扩展”图标(快捷键 Ctrl + Shift + X,macOS 为 Cmd + Shift + X),在搜索框输入 Python。在搜索结果中找到由 Microsoft 官方发布的扩展包(标识符为 ms-python.python),点击“安装(Install)”。该扩展为 VSCode 提供了代码运行按钮、自动补全、语法检查以及虚拟环境管理等能力。

VSCode怎么运行执行python脚本
图 1:VSCode 运行 Python 脚本的四个阶段流程

3. 选择当前项目的 Python 解释器

当一台电脑上存在多个 Python 环境(例如全局安装的 Python、conda 虚拟环境或项目私有的 venv)时,必须明确告知 VSCode 当前项目调用哪一个解释器:

  1. 按快捷键 Ctrl + Shift + P(macOS 为 Cmd + Shift + P)打开顶部命令面板。
  2. 在输入框输入 Python: Select Interpreter 并回车。
  3. 列表中会列出检测到的所有解释器路径。点击选中目标环境;如果列表中未自动扫描出自己创建的虚拟环境,可以点击“Enter interpreter path...”手动浏览指定虚拟环境目录下的 python.exe(Windows)或 bin/python(macOS/Linux)。

选择完成后,VSCode 界面右下角的状态栏会显示当前绑定的 Python 版本及环境名(如 3.11.8 ('venv': venv))。

二、在 VSCode 中运行 Python 脚本的 5 种方式

完成环境配置后,新建一个名为 demo.py 的文件并输入一段标准测试代码,用于验证运行机制:

# demo.py 示例代码
import sys

def main():
    print("Python 脚本在 VSCode 中顺利执行!")
    print(f"当前使用的解释器路径: {sys.executable}")
    print(f"Python 核心版本: {sys.version.split()[0]}")

if __name__ == "__main__":
    main()
VSCode怎么运行执行python脚本
图 2:VSCode 运行 Python 脚本的五种常用途径横向对比

方式 1:点击右上角的三角形运行按钮(最推荐)

这是日常开发中最常用、最顺手的操作方式。只要编辑器当前处于打开的 .py 标签页,在右上角工具栏即可看到一个形如“播放键”的绿色/灰色三角形图标。

  • 直接点击三角形图标,其默认行为是“在终端中运行 Python 文件(Run Python File in Terminal)”。
  • 如果三角形右侧带有下拉小箭头,点击小箭头可以在“Run Python File”与“Debug Python File”之间自由切换。
  • 点击后,VSCode 底部面板会自动呼出“终端(Terminal)”,自动激活所选虚拟环境,并输出代码打印的所有结果。

方式 2:编辑区右键菜单运行

在编辑器任意代码空白区域单击鼠标右键,在弹出的上下文菜单中向下寻找并点击 “在终端中运行 Python” → “在终端中运行 Python 文件”(英文菜单为 Run Python → Run Python File in Terminal)。执行结果与方式 1 完全一致。

方式 3:使用内置集成终端命令行执行

当编写的脚本需要接收命令行传参(例如通过 argparse 或 sys.argv 接收参数),或者需要使用重定向管道时,通过命令行运行是最精确的方式:

  1. 使用快捷键 Ctrl + `(反引号,键盘数字 1 左侧)打开 VSCode 内置终端。
  2. 终端默认已经切换至当前项目的根工作目录。
  3. 在终端提示符后手动输入命令并回车:
# 基础运行(终端已激活虚拟环境时直接调用 python)
python demo.py

# 脚本位于子文件夹时
python src/demo.py

# 带有命令行传参的脚本
python demo.py --debug --batch-size 32
命令行运行结果示例(控制台真实回显模拟):
PS D:\Project\python-demo> & D:/Project/python-demo/.venv/Scripts/python.exe d:/Project/python-demo/demo.py
Python 脚本在 VSCode 中顺利执行!
当前使用的解释器路径: D:\Project\python-demo\.venv\Scripts\python.exe
Python 核心版本: 3.11.8

方式 4:选中代码交互式执行(Shift + Enter)

在进行数据清洗、科学计算或探索性数据分析时,往往不需要从头到尾重复执行整份脚本,而是希望分段测试代码:

  • 用鼠标选中想要执行的一行或多行代码。
  • 按下快捷键 Shift + Enter。
  • VSCode 会在底部自动启动一个 Python 交互式终端(REPL),将选中的语句发送进去执行并立即打印变量值。后续选中的代码可以复用前面定义好的变量与导入的模块。

方式 5:按 F5 键启动调试执行

当脚本运行出现逻辑偏差或抛出异常时,可通过调试模式逐行检查内部状态:

  • 在代码行号左侧单击鼠标左键,生成一个红色的断点圆点。
  • 按下快捷键 F5(或者在左侧活动栏切换到“运行和调试”面板,点击“运行和调试”按钮)。
  • 在顶部弹出的调试配置菜单中选择“Python 调试器:Python 文件(Python Debugger: Python File)”。
  • 程序运行至断点处会自动暂停,此时左侧面板会清晰展现当前所有局部变量的值、调用栈,并允许在顶部调试栏单步跳过(F10)或单步进入(F11)。
  • 如果只是想快速执行而不受断点拦截,可使用快捷键 Ctrl + F5(免调试启动)。

三、VSCode 运行 Python 的底层机制解析

许多初学者在遇到报错时感到困惑,本质在于不了解“点击运行”背后发生了什么。从点击按钮到屏幕输出,VSCode 经历了清晰的分层调用链:

VSCode怎么运行执行python脚本
图 3:VSCode 运行 Python 脚本的调用链与交互流程

正如上图所示,当你在 VSCode 界面点击“运行”时,VSCode 并不直接执行 Python 代码,而是做了一次“任务委托”:

  • 信息整合:VSCode 收集当前激活的文件绝对路径,并读取右下角配置的 Python 解释器路径。
  • 终端拼接:扩展程序在 VSCode 的“终端”面板中开启一个系统 Shell(Windows 上为 PowerShell 或 CMD,macOS/Linux 上为 zsh 或 bash),并向终端发送一条完整的命令行字符串(例如 & /path/to/python /path/to/demo.py)。
  • 独立进程:操作系统启动 Python 进程,解释器读取磁盘中的代码并解释执行。
  • 回显呈现:Python 进程产生的标准输出(stdout)与错误输出(stderr)被终端窗口实时捕获并滚动显示在屏幕下方。

四、常见运行异常与排查对策

在实际执行 Python 脚本过程中,常见的问题通常集中在解释器找不到、第三方依赖包报错以及路径混淆三类情况:

VSCode怎么运行执行python脚本
图 4:VSCode 执行 Python 常见问题排查与解决路线

1. 提示 “'python' 不是内部或外部命令”

原因排查:直接在终端输入 python 命令时,操作系统未在环境变量 PATH 中找到名为 python 的可执行文件;或者在 VSCode 中尚未指定有效的解释器。

解决方法:

  1. 按快捷键 Ctrl + Shift + P,输入 Python: Select Interpreter。
  2. 点击“输入解释器路径...”,手动定位到本地 Python 安装目录下的 python.exe 文件。
  3. 若需要全局生效,进入系统高级系统设置,在环境变量的“系统变量 - Path”中将 Python 安装目录及其下的 Scripts 目录完整添加进去,并重启 VSCode。

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

原因排查:很多开发者在系统终端里执行了 pip install pandas,但在 VSCode 中点击运行却报错找不到该包。这是因为 VSCode 选中的 Python 解释器与你在外部安装包的环境属于不同的 Python 副本。

解决方法:

  • 在 VSCode 内置终端中,检查当前环境真正指向的路径:
    # Windows 下查看路径
    where python
    
    # macOS / Linux 下查看路径
    which python
  • 确保在 VSCode 右下角选择的解释器,正是你安装了依赖库的那一个环境(如 Anaconda base 环境或项目自定义虚拟环境)。
  • 或者直接在 VSCode 的内置终端中重新执行安装命令:python -m pip install xxx,确保依赖准确安装进当前被调用的解释器目录中。

3. 读取本地文件时出现 “FileNotFoundError”

原因排查:例如代码中写了 open("data.txt"),文件明明与 demo.py 放在同一个子文件夹下,运行却报错找不到文件。这是因为 Python 解析相对路径是以终端当前工作目录(Current Working Directory, CWD)为基准,而不是以脚本文件自身所在的目录为基准。

规范写法:在脚本中利用 pathlib 或 os.path 动态计算文件所在绝对目录,避免依赖外部启动路径:

from pathlib import Path

# 获取当前脚本所在文件夹的绝对路径
BASE_DIR = Path(__file__).resolve().parent
file_path = BASE_DIR / "data.txt"

with open(file_path, "r", encoding="utf-8") as f:
    content = f.read()
    print(content)

五、运行方式特性速查表

为了便于在不同场景下快速决定使用何种执行途径,可参考下表的对比特性:

运行途径 触发方式 优势特性 适用典型场景
顶部三角按钮 右上角一键点击 自动绑定环境并打开终端,操作成本最低 日常单文件快速测试、查看执行结果
右键上下文菜单 代码区右键选择 无需将光标移至窗口右上角,操作连续 纯鼠标编辑时的便捷运行
集成终端命令 终端内输入 python file.py 完全掌控启动参数、环境变量与标准管道 带参数脚本、CLI 工具、后台批量批处理
交互选区执行 选中代码 + Shift + Enter 变量常驻内存,无需重复加载大型数据源 数据分析、算法逻辑微调、探索性实验
F5 调试器运行 按 F5 启动 Debug 支持断点拦截、变量值监视、单步跟踪 逻辑查错、排查异常调用栈、复杂项目定位

掌握以上配置与执行方式后,在 VSCode 中运行 Python 脚本即可做到环境清晰、调用可控,并在出现问题时迅速对齐解释器与工作路径。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。