VS Code中点击运行Python文件按钮可运行脚本 按F5键无法运行

故障表现 #

• 点击编辑器右上角「运行Python文件」按钮时，目标Python脚本可正常执行
• 按下F5快捷键、或通过顶部菜单栏选择运行/调试选项时，同一份脚本无法正常启动；提前添加断点后触发运行，调试功能完全不生效，不会命中断点
• Python交互窗口执行代码、运行Notebook文件功能均正常，无异常

核心原因 #

这个故障和快捷键绑定缺失的关联度极低，90%以上的触发场景来自三类问题：

1. 工作区调试配置损坏：右上角运行按钮走的是Python扩展内置的无配置快速执行逻辑，完全不依赖工作区配置；但F5、菜单栏运行默认优先读取工作区.vscode/launch.json中的调试配置，文件缺失、配置项错误、指向不存在的Python解释器/脚本路径时，就会出现启动无响应的问题
2. 调试依赖组件异常：F5调试运行依赖独立的debugpy调试适配器，和右上角运行、交互窗口、Notebook用的轻量执行逻辑不是一套组件；如果debugpy版本和Python扩展不匹配、安装损坏，就会导致调试流程完全不触发
3. 快捷键冲突：如果安装了键位映射类扩展、其他开发类扩展抢占了F5的键位绑定，会导致按F5时触发的不是Python调试启动命令

修复步骤（按优先级操作，每步完成后可测试是否恢复） #

• 重置调试配置
  按下Ctrl+Shift+P（macOS系统按Cmd+Shift+P）调出命令面板，输入Debug: Select and Start Debugging，在弹出列表中选择Python File选项，测试是否能正常启动脚本。如果可以正常运行，直接删除当前工作区.vscode文件夹下的launch.json文件，重启VS Code后会自动生成符合默认规则的正确配置。
• 修复调试依赖组件
  在命令面板输入Python: Clear Workspace Interpreter Setting清空当前工作区绑定的无效解释器，重新选择本地已正确安装的可用Python解释器；之后输入Developer: Reload Window重载窗口，Python扩展会自动下载匹配版本的debugpy组件。
  如果上述操作无效，卸载已安装的Python扩展，手动删除用户目录下.vscode/extensions路径内的ms-python.python、ms-python.debugpy两个文件夹，重新安装最新版Python扩展即可。
• 排查快捷键冲突
  按下Ctrl+K Ctrl+S（macOS系统按Cmd+K Cmd+S）打开键盘快捷键设置面板，搜索workbench.action.debug.start命令，查看该命令的默认绑定是否为F5；如果存在其他扩展的F5绑定项，右键选择删除冲突绑定，保留调试启动的默认键位即可。

修复验证：在代码行号左侧点击添加断点，按F5启动后程序会在断点位置自动暂停，左侧调试面板可正常查看当前上下文变量、调用栈信息，即为功能恢复正常。

内容的提问来源于stack exchange，提问作者darren