必须手动配置Python解释器路径,否则VS Code无法运行脚本;即使右下角显示Python版本,若未在工作区中真正激活(如未通过Open Folder打开文件夹、未执行Python: Select Interpreter确认、路径含空格/中文、虚拟环境未先激活再选择),仍会静默失败或报错。

VS Code 本身不带 Python 运行能力,必须手动配解释器路径,否则点运行按钮只会报错 Command 'Python: Run Python File in Terminal' resulted in an error 或直接没反应。
为什么选了 Python 解释器还不能运行?
常见现象是左下角显示了 Python 版本(比如 Python 3.12.4),但右键运行仍失败。本质原因是 VS Code 没真正“激活”该解释器——它只在状态栏显示,不等于已加载到当前工作区的 Python 扩展上下文中。
- 必须打开一个文件夹(
File > Open Folder),不能只打开单个.py文件 - 首次打开文件夹后,要等右下角弹出“Select interpreter to continue”提示,或手动按
Ctrl+Shift+P输入Python: Select Interpreter并确认一次 - 如果解释器路径含空格或中文(如
C:\Program Files\Python\python.exe),VS Code 有时会静默失败;建议重装 Python 到纯英文无空格路径(如C:\py312\)
运行代码时终端一闪而过,看不到输出
这是 Windows 用户最常遇到的问题:VS Code 默认用集成终端运行,但某些系统配置或扩展冲突会导致终端未保持打开。不是代码错了,是执行环境没稳住。
- 最简单解法:在
.py文件里加一句input("按回车退出..."),强制暂停 - 更彻底的改法:按
Ctrl+Shift+P→ 输入Preferences: Open Settings (JSON)→ 在settings.json里加一行:"python.defaultInterpreterPath": "你的python.exe绝对路径" - 不想改配置?右键文件时选
Run Python File in Terminal(不是Run Python File in Interactive Window),确保终端窗口被复用而非新建
虚拟环境(venv)怎么让 VS Code 识别?
用 python -m venv .venv 创建后,VS Code 不会自动切换过去——它只认“已激活”的环境,而不是文件夹里有 .venv 就行。
立即学习“Python免费学习笔记(深入)”;
- 先在 VS Code 集成终端里手动激活:
.venv\Scripts\activate(Windows)或source .venv/bin/activate(macOS/Linux) - 激活成功后,再按
Ctrl+Shift+P→Python: Select Interpreter,此时列表顶部会出现./.venv/Scripts/python.exe这类带路径的选项,选它 - 关键细节:VS Code 的 Python 扩展会读取激活后的
PYTHONPATH和PATH,所以必须先激活再选解释器,顺序不能反
最容易被忽略的一点:每次换项目文件夹,都要重新走一遍 Python: Select Interpreter。VS Code 不跨工作区继承解释器设置,哪怕你刚在隔壁文件夹选过同一个 python.exe,它也不会帮你记住。



















