VSCode 终端中的鼠标点击事件导致的长代码运行意外暂停

用 VSCode 终端跑着长任务，手一滑点了下鼠标，屏幕瞬间定格——代码“死”了？别慌，这在技术圈里太常见了，不是程序崩了，是终端进入了“鼠标选择模式”，后台安静地发了个 SIGTSTP 信号，把前台进程挂起来了。这事儿跟操作系统无关，Windows、macOS、Linux 都一个样，VSCode 的集成终端不过是继承了 pty 终端的底层行为。

这种现象其实有迹可循：你双击选中一行、拖拽划词，甚至只是在空白处点了一下（尤其在 PowerShell 或 zsh 下），终端就会自动停掉当前正在跑的前台进程——比如 python train.py 或 node server.js。光标不动了，输出也没了，但进程并没有退出，只是进入 Stopped 状态。此时如果 Ctrl+C 无效，jobs 却显示 [1]+ Stopped，那基本就坐实了是鼠标点击闯的祸。

背后原理其实很直白：终端仿真器检测到鼠标事件，立刻切换到选择模式，然后向前台进程组发送 SIGTSTP。所有基于 libpty 的终端，包括 VSCode 默认终端、iTerm2、GNOME Terminal 都会中招，跟用的是 bash 还是 zsh 无关。Windows 上需要注意一点：PowerShell v5.1 及更早版本反应尤其灵敏，点一下就停；而 PowerShell 7+ 和 Windows Terminal 虽然有明显改进，但偶尔还是能触发。

怎么立刻恢复被鼠标暂停的程序？

别急着关终端或者重启进程，作业控制命令就能解决。先拿 jobs 确认一下——如果看到类似 [1]+ Stopped python main.py 的输出，那说明它确实被挂起了。然后用 fg（最常用）或 fg %1（指定作业号）把它拉回前台继续跑。要是你不希望它占着终端，也可以用 bg 或 bg %1 让它后台运行，想拉回来再用 fg 就行。

还有一种情况：jobs 返回空，但程序还是没反应。这可能是鼠标点击触发了终端的“复制模式”，尤其是 tmux 嵌套或某些 zsh 主题下更容易出现。此时按一下 Esc 退出选择态，通常就能恢复。

怎么避免鼠标一点就停？

根本解法不是禁用鼠标——那会让你没法选中文本——而是切断“点击→暂停”这条默认链路。

在 Linux/macOS 上，可以在 shell 配置（~/.bashrc 或 ~/.zshrc）中加入一行 set -o vi 或 set -o emacs，同时配以 stty -ixon，后者关闭了 Ctrl+S/Ctrl+Q 流控，间接降低鼠标事件干扰的概率。需要说明的是，这并不代表作业控制被禁用。

PowerShell 用户推荐在 VSCode 设置里改动终端 profile，把默认终端从 Powershell 换成 Command Prompt 或 Windows Terminal（路径设为 wt.exe），后者对鼠标事件的处理更克制。

在 VSCode 全局设置方面，可以添加 "terminal.integrated.enableMultiLinePaste": false，减少粘贴相关状态切换；同时确保 "terminal.integrated.copyOnSelection": false，避免选中即复制触发状态变更。这两个设置能有效降低鼠标事件带来的副作用。

如果任务特别重要，终极保险方案是提前用 nohup python script.py & 或 screen -S job 启动。这样一来，鼠标点击只影响当前的 shell 会话，主进程安然无恙。

为什么 Ctrl+C 在鼠标暂停后失效？

这个问题让不少人困惑。因为 Ctrl+C 发送的是 SIGINT 信号，而被 SIGTSTP 挂起的进程处于“不可中断睡眠”状态（T 状态），信号队列会被阻塞，直到进程被 fg 或 bg 唤醒后才会批量处理。

要验证这一点，可以用 ps -o pid,stat,comm -C python（Linux/macOS）或 tasklist /fi "imagename eq python.exe"（Windows）查看进程状态列，如果是 T，那就说明它在等待唤醒。

如果 fg 不方便，也可以用 kill -CONT $(pgrep -f "python.*script") 强行发送继续信号，但这需要知道 PID，远不如 fg 来得直接。而在调试器场景下更麻烦：F5 启动的调试进程不走终端作业控制，鼠标点击不会暂停它，但会暂停其 stdout/stderr 输出终端——此时 Shift+F5 才是唯一有效的停止方式。

鼠标暂停这件事，不报错、不留日志、不弹提示，非常容易误判为程序崩溃或死循环。核心口诀就一句：只要 jobs 能列出东西，就还有救，别急着关终端。