VS Code怎么运行Python代码:安装插件与选择解释器
本文详细讲解在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 进行后续操作。
二、安装 Python 扩展插件
为了让 VS Code 获得代码高亮、智能补全、语法检查以及一键运行等能力,必须在扩展市场中安装微软官方发布的 Python 插件。
操作步骤:
- 打开 VS Code,在左侧活动栏点击“扩展”图标(图标形状为四个方块,快捷键为 Windows: Ctrl + Shift + X,macOS: Cmd + Shift + X)。
- 在扩展面板顶部的搜索框中输入
Python。 - 在搜索结果中找到由 Microsoft 官方发布的插件(标识通常为蓝黄相间的 Python Logo,发布者为 Microsoft)。
- 点击该插件右侧的 Install(安装) 按钮。安装完成后,系统通常会自动配套安装 Pylance 插件,用于提供强大的类型推断和自动补全。
三、选择与切换 Python 解释器
安装插件后,VS Code 并不会盲目调用系统默认命令,而是允许用户显式指定使用哪一个解释器。当电脑上安装了多个 Python 版本,或者创建了虚拟环境(如 venv、conda)时,正确指定解释器能够确保代码引用的依赖包与运行环境严格匹配。
详细步骤说明:
- 使用快捷键 Ctrl + Shift + P(macOS 用户按 Cmd + Shift + P)调出顶部的全局命令面板。
- 在提示框中输入
Python: Select Interpreter并按回车。 - 此时列表中会列出检测到的全部环境,包括全局 Python、虚拟环境(
.venv)或 Anaconda 环境。点击需要使用的项即可。 - 验证结果:观察 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
五、常见问题排查与注意事项
在实际配置过程中,初学者常遇到以下两类典型问题:
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,允许加载当前用户的本地脚本。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













