VSCode中Python按F5一次却多次执行的问题排查与解决

可能的原因 #

• launch.json配置错误：这是最常见的诱因。如果你的.vscode/launch.json里存在多个调试配置项，或者某个配置的preLaunchTask指向了会执行代码的任务，就会出现调试前先跑一次任务、再启动调试的情况，看起来像是代码执行了多次。另外，program路径配置错误、stopOnEntry等参数设置不当，也可能触发重复启动逻辑。
• 终端残留进程未终止：之前的调试或运行进程没有彻底关闭，新启动的调试又创建了新进程，多个进程同时输出内容，就会让你误以为代码被多次执行。尤其是手动关闭终端窗口但后台进程仍在运行时，这种情况更容易出现。
• Python扩展的配置冲突或bug：比如扩展的python.terminal.executeInFileDir设置与调试逻辑冲突，或者当前使用的扩展版本存在bug，导致每次调试时重复触发运行命令。
• tasks.json任务重复触发：如果配置了自动执行的任务（比如打开文件夹、保存文件时自动运行代码），调试操作叠加自动任务的执行，就会出现多次运行的现象。

解决办法 #

• 修正launch.json配置：
  1. 打开.vscode/launch.json（没有的话通过调试面板的「创建launch.json文件」生成默认配置）。
  2. 删除多余的configurations条目，只保留当前需要的调试配置。
  3. 检查preLaunchTask字段：不需要预启动任务就直接删除该字段；若需要，确认对应的任务不会执行你的代码。
  4. 确保program字段指向正确的脚本文件，推荐用${file}表示当前打开的活动文件。
• 清理终端及残留进程：
  1. 在VSCode终端面板右上角点击垃圾桶图标，关闭所有终端窗口。
  2. 打开系统任务管理器（Windows）或活动监视器（Mac），找到并结束所有残留的Python进程。
  3. 重新启动调试，观察问题是否消失。
• 重置或更新Python扩展：
  1. 打开VSCode扩展面板，找到Python扩展，点击齿轮图标选择「重置扩展设置」，恢复默认配置。
  2. 若重置无效，检查扩展是否有可用更新，升级到最新版本后重试。
• 检查tasks.json自动任务：
  1. 打开.vscode/tasks.json，查看是否有自动触发的任务（比如带有"runOn": "folderOpen"或保存触发的配置）。
  2. 暂时禁用这类自动任务，或修改触发条件，避免与调试操作冲突。

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