vs code运行python需三步:显式指定解释器路径、启用python扩展、工作区设为文件夹。未设解释器则调试/补全/导入失败;未装扩展则无语法高亮和智能提示;未用虚拟环境则包管理混乱;缺launch.json则f5调试失效。

VS Code 写 Python 不是装完就能跑,核心就三件事:解释器路径必须显式指定、Python 扩展必须启用、工作区得是文件夹而非单个文件。
Python 解释器路径没设对,所有功能都失效
VS Code 不继承终端的 PATH 或虚拟环境激活状态,不手动选解释器,print() 能运行但调试、补全、import 都可能报错。常见现象包括:
- 右下角状态栏不显示 Python 版本,或显示“Not found”
- F5 启动调试时提示 “No Python interpreter selected”
- 输入
import requests后标红,但终端里pip list明明有
解决方法只有两个可靠入口:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并选择Python: Select Interpreter - 若列表为空,点
Enter interpreter path…,粘贴which python3(macOS/Linux)或where python(Windows)查到的绝对路径 - 选完后务必关闭整个 VS Code 窗口再重开——仅刷新标签页不生效
Python 扩展没装或没启用,代码就是纯文本
VS Code 本身不带 Python 支持,ms-python.python 扩展是所有智能功能的唯一来源。没它:
- 没有语法高亮(.py 文件像 .txt)
-
Ctrl+Space补全不出任何函数或变量 - 跳转定义(
F12)、查看类型(Ctrl+Hover)全部失效
安装后必须重启 VS Code 才能激活。验证方式:打开命令面板,搜 Python:,能看到一长串命令(如 Python: Create Environment)即表示已就位。
用虚拟环境却没在工作区里选它,包管理全乱套
直接用全局 Python 安装包,项目迁移或协作时极易出问题。正确做法是每个项目配独立环境:
- 终端进项目根目录,执行
python -m venv .venv(Windows)或python3 -m venv .venv(macOS/Linux) - 运行
Python: Select Interpreter,从列表中选.venv/bin/python(macOS/Linux)或.venv\Scripts\python.exe(Windows) - 此时终端自动激活该环境(右下角会显示
.venv),pip install装的包只在这个项目里生效
别信“自动识别”——VS Code 不会主动扫描 .venv 文件夹,必须人工点选。
launch.json 不配,F5 就只是摆设
调试依赖 launch.json,不是按 F5 就能进断点。最简配置只需一步:
- 按
Ctrl+Shift+D进调试侧边栏 → 点“创建 launch.json 文件” → 选Python File - 生成的配置里确保
"program": "${file}"和"console": "integratedTerminal"存在 - 如果想让程序运行完不自动关终端,加一行
"stopOnEntry": false
漏掉这步,F5 会弹窗报错,而不是运行代码。
最容易被忽略的是:解释器路径一旦写死在 settings.json 里(比如 "python.defaultInterpreterPath": "./.venv/bin/python"),后续换项目必须手动删掉这行,否则新项目会强行复用旧环境的解释器——连 Python: Select Interpreter 都覆盖不了这个配置。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











