“尝试在未运行的调试会话上操作”是VSCode因调试状态与UI脱节而主动拒绝操作，常见于进程崩溃未清理、多配置切换错乱或nodemon热重载未同步；应执行Debug: Stop终止残留会话，并优化launch.json与settings.json配置防复发。
“尝试在未运行的调试会话上操作”不是报错，而是 VSCode 的明确拒绝——它没在调试，你却点了继续、单步或重启。 本质是 UI 操作与底层调试状态脱节，常见于断点命中后手动停掉进程、调试崩溃未清理、或误点调试工具栏按钮。修复不靠重装，靠同步状态和切断残留连接。
为什么会出现“未运行的调试会话”提示
VSCode 调试器内部维护一个 session 状态机，一旦实际进程退出（比如 node 进程崩溃、Ctrl+C 中断、Docker 容器关闭），但 UI 仍显示“正在调试”或保留旧的调试工具栏，此时点击“继续”“单步跳过”等按钮就会触发该提示。
- 你看到的“暂停”图标可能是假象——进程早已退出，只是 UI 没刷新
- 多配置共存时（如同时有
Launch Program和Attach to Process），切换配置但未停止前一个会话，状态容易错乱 - 使用
nodemon热重载时，进程被杀掉再拉起，但 VSCode 有时没及时感知新进程 PID，导致 attach 失败后残留旧 session
强制终止残留调试会话（最直接有效）
不要关窗口、不要重启 VSCode——先清空调试上下文。
- 按下
Shift+Cmd+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Debug: Stop并回车；如果列表里没有，输入Developer: Toggle Developer Tools，在 Console 里粘贴执行：debug.stop() - 检查底部状态栏：如果仍有“调试”字样或播放/暂停图标，右键点击它 → 选择
Stop Debugging - 确认调试面板（
Cmd+Shift+D）里所有会话都已灰色不可用，且“调试控制台”输出中不再有Debugger attached或Process exited类日志
避免下次再出现的关键配置项
这个提示反复出现，往往是因为 launch.json 缺少容错机制，尤其在开发态频繁启停时。
- 在
launch.json的 configuration 中添加："stopOnEntry": false（避免入口就断住卡死状态） - 对
nodemon方式，务必加"restart": true和"console": "integratedTerminal"，否则 VSCode 无法接管子进程生命周期 - 禁用自动附加行为：在
settings.json中设"debug.allowBreakpointsEverywhere": false，防止断点被错误地注册到未加载模块上 - 如果用 Docker 或 PM2，别依赖
Attach to Process配置自动发现——改用固定端口 +"port": 9229+"address": "localhost"显式指定，减少连接抖动
真正麻烦的不是提示本身，而是它背后隐藏的“调试会话生命周期管理失控”。只要进程退出后 VSCode 没收到 clean shutdown 信号，就可能残留僵尸 session。所以每次调试结束，养成按 Shift+Cmd+P → Debug: Stop 的习惯，比什么都可靠。
