VSCode安装Python扩展 小白必备VSCode运行Python教程

云芳君_7688

云芳君_7688

2026-04-14

607人浏览

原创

vscode不能直接运行python,必须安装ms-python.python扩展并手动选择正确解释器路径,否则绿色按钮、f5调试或右键运行均会失败;状态栏需显示具体python版本及路径,且推荐优先通过终端命令验证、再用绿色按钮运行。

vscode安装python扩展 小白必备vscode运行python教程

VSCode 能不能直接运行 Python?不能——它必须装 ms-python.python 扩展,且手动选对解释器,否则点绿色按钮、按 F5 或右键“运行”全会失败,报错也常不明确,比如只显示“command 'python.execInTerminal' not found”或空白终端。

为什么装了扩展还不能运行 Python?

因为 VSCode 默认不认识你的 Python 解释器在哪。它不读系统 PATH,也不自动调用 which python 的结果。即使终端里 python --version 能正常输出,VSCode 依然可能完全找不到解释器。

  • 状态栏左下角不显示 Python 版本路径(如 Python 3.12.4 ('venv')),说明解释器没选上
  • 点右上角绿色三角运行时,终端弹出但瞬间关闭,或提示“找不到 python 命令”,大概率是解释器路径为空或指向错误
  • 用右键菜单里的“在终端中运行 Python 文件”看似能跑,但实际调用的是系统默认 python,不是你项目虚拟环境里的,pip install 的包很可能导入失败

Python: Select Interpreter 怎么选才对?

快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Python: Select Interpreter 回车后,列表里优先选带 (venv) 或 (conda) 后缀的项;如果没有,再找路径明确指向你安装目录的项,比如:

  • Python 3.12.4 ('System') - /usr/bin/python3(macOS/Linux)
  • Python 3.12.4 (venv) - /path/to/your-project/.venv/bin/python
  • Python 3.12.4 - C:UsersNameAppDataLocalProgramsPythonPython312python.exe(Windows)

别选“Enter interpreter path”后随便点一个 python.exe 就完事——如果那个路径下没有你 pip 安装的包(比如 requests),运行时照样报 ModuleNotFoundError。

python 查询技能
python 查询技能

查询客流数据,输出JSON格式,可直接导入Bitable等可视化工具

下载

运行 Python 文件的三种方式,哪种最可靠?

推荐顺序:先用终端命令验证,再用绿色按钮,最后考虑调试。三者底层依赖同一个解释器配置,但触发逻辑不同:

  • 在集成终端里手动执行 python main.py —— 最透明,能立刻看到路径、权限、模块缺失等真实错误
  • 点击右上角绿色三角 —— 依赖当前已选解释器,且只对已保存的 .py 文件生效;未保存时点它会静默失败
  • 按 F5 启动调试 —— 需要 .vscode/launch.json 配置,新手建议先禁用自动生成功能,避免生成错误模板导致“no configuration”报错

特别注意:Code Runner 插件的“Run Code”右键菜单和官方 Python 扩展无关,它硬编码调用 python 命令,极易与你选的解释器不一致,小白阶段建议卸载或禁用。

虚拟环境不识别?检查 .vscode/settings.json

VSCode 把解释器选择结果写进工作区级配置文件 .vscode/settings.json,而不是全局设置。如果你换了项目、复制了代码、或从 Git 克隆仓库,这个文件很可能不存在或路径已失效。

  • 打开项目根目录 → 查看是否有 .vscode 文件夹 → 进入后检查 settings.json 是否含 "python.defaultInterpreterPath" 字段
  • 字段值如果是相对路径(如 ".venv\Scripts\python.exe"),确保该路径真实存在且没被删掉
  • 如果字段指向旧环境(比如重装 Python 后路径变了),手动改掉,或干脆删掉这行,再重新运行 Python: Select Interpreter

真正容易被忽略的,是工作区配置的“隐形绑定”——它不会提醒你路径失效,只会让所有运行行为悄悄退化到系统默认 Python,而你可能几天后才发现 numpy 导入失败,却以为是代码写错了。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python vscode vscode安装

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2055

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3062

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1036

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3459

7

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

2810

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

6463

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

8062

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

4027

16

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

5919

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程