VS Code怎么运行Python代码:安装插件与选择解释器

顾言
顾言
发布时间:2026-11-17| 6人浏览过
原创

本文详细讲解在Visual Studio Code中运行Python代码的完整流程,包括安装官方Python扩展、选择与切换Python解释器、编写并运行首个脚本,以及常见运行报错与排查方法。

在 Visual Studio Code(简称 VS Code)中运行 Python 代码,核心逻辑可以总结为两步:一是为编辑器安装官方 Python 扩展,使其具备语法分析、调试与执行入口;二是指向系统已经安装的 Python 解释器可执行文件。完成这两项配置后,编辑器就能调用底层的 Python 环境执行代码并在内置终端输出结果。

一、准备工作:确认本地已安装 Python

VS Code 本质是一个功能强大的代码编辑器,自身并不包含 Python 运行环境。如果在电脑中尚未安装 Python 解释器,VS Code 即使安装了扩展也无法执行任何代码。因此,在配置编辑器之前,需要先确认操作系统已具备可用的 Python 环境。

可以打开操作系统自带的终端(Windows 的 PowerShell 或 macOS/Linux 的 Terminal),输入以下命令检查版本:

python --version
# 如果系统使用 python3 别名,可执行:
python3 --version

示例输出:

Python 3.11.4

如果终端提示“找不到命令”或“不是内部或外部命令”,说明电脑尚未安装 Python 或未将其添加至系统环境变量。此时需要先前往 Python 官方网站下载安装包完成安装(Windows 用户请务必在安装界面勾选“Add python.exe to PATH”),然后再回到 VS Code 进行后续操作。

VS Code怎么运行Python代码:安装插件与选择解释器
图 1:VS Code、Python 扩展与操作系统解释器之间的协作与调用拓扑

二、安装 Python 扩展插件

为了让 VS Code 获得代码高亮、智能补全、语法检查以及一键运行等能力,必须在扩展市场中安装微软官方发布的 Python 插件。

操作步骤:

  1. 打开 VS Code,在左侧活动栏点击“扩展”图标(图标形状为四个方块,快捷键为 Windows: Ctrl + Shift + X,macOS: Cmd + Shift + X)。
  2. 在扩展面板顶部的搜索框中输入 Python。
  3. 在搜索结果中找到由 Microsoft 官方发布的插件(标识通常为蓝黄相间的 Python Logo,发布者为 Microsoft)。
  4. 点击该插件右侧的 Install(安装) 按钮。安装完成后,系统通常会自动配套安装 Pylance 插件,用于提供强大的类型推断和自动补全。
注意事项:应用商店中存在许多第三方 Python 相关插件,请认准带有官方蓝标验证的 Microsoft 版本,避免安装非必要或过期的扩展包。

三、选择与切换 Python 解释器

安装插件后,VS Code 并不会盲目调用系统默认命令,而是允许用户显式指定使用哪一个解释器。当电脑上安装了多个 Python 版本,或者创建了虚拟环境(如 venv、conda)时,正确指定解释器能够确保代码引用的依赖包与运行环境严格匹配。

VS Code怎么运行Python代码:安装插件与选择解释器
图 2:通过 VS Code 命令面板选择 Python 解释器的具体执行步骤

详细步骤说明:

  1. 使用快捷键 Ctrl + Shift + P(macOS 用户按 Cmd + Shift + P)调出顶部的全局命令面板。
  2. 在提示框中输入 Python: Select Interpreter 并按回车。
  3. 此时列表中会列出检测到的全部环境,包括全局 Python、虚拟环境(.venv)或 Anaconda 环境。点击需要使用的项即可。
  4. 验证结果:观察 VS Code 界面右下角状态栏。如果配置成功,状态栏会显示所选版本号(例如 3.11.4 64-bit 或带有 ('venv': venv) 的标签)。直接点击该状态栏区域,也可以快速唤起解释器切换列表。
如果列表为空怎么办?
若列表中未找到需要的 Python,可在弹出的列表首项选择 “Enter interpreter path...”(输入解释器路径),点击 “Find...(浏览查找)”,手动导航到 Python 可执行文件所在位置(Windows 为 python.exe,macOS/Linux 为 bin/python)。

四、编写与运行 Python 代码的常用方式

完成上述两项基本配置后,即可创建文件并运行测试。

1. 新建代码文件

在 VS Code 的资源管理器面板中点击“新建文件”,将其命名为 main.py(必须以 .py 为后缀,以便编辑器识别 Python 语言模式)。输入以下测试代码:

# main.py
import sys

def main():
    message = "Hello, VS Code & Python!"
    print(message)
    print("当前运行的解释器路径:")
    print(sys.executable)

if __name__ == "__main__":
    main()

2. 运行代码的三种主要途径

  • 途径一:右上角播放按钮(推荐)
    打开 .py 文件后,编辑器右上角会出现一个绿色的三角形播放按钮(Run Python File)。直接点击该按钮,VS Code 会自动在下方拉起内置终端,并在所选解释器环境下执行该文件。
  • 途径二:右键菜单运行
    在编辑区代码任意位置单击鼠标右键,在上下文菜单中选择 “Run Python > Run Python File in Terminal”(在终端中运行 Python 文件)。
  • 途径三:内置终端直接执行命令行
    通过快捷键 Ctrl + `(反引号)打开终端,直接输入命令执行:
    python main.py

示例终端运行结果:

Hello, VS Code & Python!
当前运行的解释器路径:
/Users/username/my-project/.venv/bin/python
VS Code怎么运行Python代码:安装插件与选择解释器
图 3:VS Code 内部触发与调用终端解释器的执行流程剖析

五、常见问题排查与注意事项

在实际配置过程中,初学者常遇到以下两类典型问题:

1. 报错 ModuleNotFoundError: No module named 'xxx'

原因分析:在终端中使用 pip install xxx 安装了第三方库,但运行代码时依然报模块不存在。这通常是因为“安装模块的 Python”和“VS Code 当前选择的解释器”不是同一个环境。

解决办法:

  • 在 VS Code 内置终端中输入 which python(macOS/Linux)或 where python(Windows),查看当前终端激活的 Python 绝对路径。
  • 对比 VS Code 右下角状态栏指示的解释器路径,确保二者一致。
  • 推荐直接在 VS Code 当前激活的终端内执行 python -m pip install 模块名,以保证包安装到当前生效的解释器环境中。

2. PowerShell 脚本执行策略受限报错

在 Windows 环境下,激活虚拟环境时终端可能会出现 ...File cannot be loaded because running scripts is disabled on this system 的错误。

解决办法:以管理员身份启动 PowerShell,运行命令 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser,允许加载当前用户的本地脚本。

VS Code怎么运行Python代码:安装插件与选择解释器
图 4:VS Code 运行 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 算法库。