vscode怎么直接F5运行python

必须安装微软官方python扩展（ms-python.python）并正确配置解释器和debugpy，否则f5无法调试；需通过ctrl+shift+p选择对应环境解释器，首次f5生成launch.json后应检查module、console和justmycode配置。

VS Code 按 F5 运行 Python 之前必须装对扩展

VS Code 默认不支持 Python 调试，F5 按下去直接报错或没反应，根本原因是你没装 Python 扩展（微软官方那个，作者是 ms-python.python）。不是 Pylance，也不是 Python Docstring Generator —— 后两者是辅助工具，不能替代调试能力。

• 必须安装 Python 扩展（带调试器、解释器选择、launch.json 生成能力）
• 卸载掉名字类似但功能残缺的“轻量 Python 插件”，它们常会干扰 debugpy 启动
• 安装后重启 VS Code，否则 F5 仍可能灰掉

按 F5 前得让 VS Code 知道用哪个 Python 解释器

F5 启动调试时，VS Code 默认找系统 PATH 里的 python，但你很可能装了 conda 环境、venv 或 pyenv 版本 —— 如果解释器选错，会报 ModuleNotFoundError 或直接卡在 “Starting the Python Debugger…”。

• 按 Ctrl+Shift+P（Win/linux）或 Cmd+Shift+P（Mac），输入 Python: select Interpreter
• 从列表里选准你的项目环境，比如 ./venv/bin/python 或 ~/miniconda3/envs/myenv/bin/python
• 选完后右下角状态栏会显示路径，确认它和你终端里 which python 输出一致

第一次 F5 会自动生成 launch.json，但默认配置容易踩坑

VS Code 在首次按 F5 时会引导你创建 .vscode/launch.json。默认选 “Python File” 看似省事，但实际藏着三个常见问题：

• "module": "runpy" 模式下无法调试 if <strong>name</strong> == "<strong>main</strong>" 外的顶层代码（比如 import 时就执行的逻辑）
• "console": "integratedTerminal" 是安全选项，但如果你用了 input()，得改成 "console": "externalTerminal"（windows）或 "console": "integratedTerminal"（macos/Linux）才不会闪退
• "justMyCode": true 是好习惯，但调试第三方库内部时要临时设为 false

示例最小可用配置：

立即学习“Python免费学习笔记（深入）”；

{   "version": "0.2.0",   "configurations": [     {       "name": "Python: Current File",       "type": "python",       "request": "launch",       "module": "runpy",       "args": ["-m", "${fileBasenameNoExtension}"],       "console": "integratedTerminal",       "justMyCode": true     }   ] }

F5 没反应 / 报错 “Could not find debugpy” 怎么办

这是最常卡住人的点：VS Code 找不到 debugpy 包。它不是 VS Code 自带的，而是依赖你当前 Python 环境里有没有装。

• 先在终端激活你的项目环境（source venv/bin/activate 或 conda activate myenv）
• 运行 pip install debugpy（注意不是 pip install python-debug 或其他名字）
• 如果用的是 conda，也可以 conda install -c conda-forge debugpy
• 装完别忘了在 VS Code 里重新触发 F5，不要只刷新窗口

调试器启动失败时，看 VS Code 底部状态栏左下角是否显示 “Debugging” —— 没显示，基本就是 debugpy 没装对环境，或者解释器路径根本没生效。

Python 调试不是“装完扩展就自动好”，解释器、debugpy、launch.json 三者必须严格对齐同一环境，漏一个，F5 就只是个按键而已。