必须将terminal.integrated.rightClickBehavior显式设为"paste"，否则Windows下默认"default"会触发系统原生菜单及同步剪贴板读取，导致大文本粘贴时主线程阻塞1–3秒，中断tail-f或train.py等长时任务；同时需清空剪贴板冗余内容并禁用监听contextmenu的终端插件。
terminal.integrated.rightClickBehavior 必须设为 "paste"
右键粘贴卡顿，90% 以上是因为这个配置没显式设对。默认值 "default" 在 Windows 上会强制走系统原生右键菜单逻辑，Electron 渲染进程同步读取剪贴板时，若内容含 ANSI 转义、HTML 片段或超过 500 行文本，就会阻塞主线程 1–3 秒，直接打断 tail -f 或 python train.py 等长时任务。
必须在 settings.json 中手动写入：
{
"terminal.integrated.rightClickBehavior": "paste"
}
不要依赖 GUI 设置面板搜索后点选——某些版本会悄悄补全成已弃用的 "terminal.rightClickBehavior"，该字段完全无效。改完后需关闭并重新打开终端标签页，仅重载窗口不生效。
粘贴前务必清空剪贴板大文本
VSCode 终端粘贴性能和剪贴板内容大小强相关。不是“能不能粘”，而是“粘的过程是否拖垮渲染线程”。当剪贴板里存着带颜色的日志、未折叠的 JSON、或含 null 字节的二进制片段，paste 操作会触发完整 UTF-8 解码 + 控制字符过滤 + 行缓冲写入，极易让终端 UI 暂停响应。
- Windows：执行
PowerShell -Command "Set-Clipboard ''" - macOS：执行
printf '' | pbcopy - Linux（X11）：执行
xclip -sel c -i /dev/null
从浏览器或富文本编辑器复制内容后，先 Paste into Notepad（或 TextEdit 纯文本模式），再复制纯文本——能直接砍掉 HTML/RTF 格式解析开销。
禁用监听 contextmenu 的终端插件
某些插件会在右键事件中注入异步逻辑，典型如 Terminal Commander、Copy Relative Path、Shell Command。它们监听 contextmenu 事件后，会尝试读路径、检查文件类型、甚至调用外部命令，哪怕只延迟 50ms，也会让粘贴“感觉卡住”，更严重的是可能中断正在输出的流式任务。
临时排查方法：
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools - 在 Console 里执行
document.querySelector('.terminal-tab').removeEventListener('contextmenu', yourHandler)（需先定位 handler） - 更稳妥的做法：禁用所有非必要终端类扩展，逐个启用验证
远程开发时关掉 clipboardSynergy
通过 Remote-SSH 或 WSL 连接时，clipboardSynergy 默认开启，它会在本地与远程之间同步剪贴板状态。但这个同步是基于 IPC 的，一旦剪贴板内容较大，就会引发跨进程阻塞，导致远程终端右键粘贴明显滞后甚至失败。
解决方法是在远程主机的 settings.json 中加：
{
"remote.ssh.enableRemoteCommandExecution": false,
"terminal.integrated.clipboardSynergy": false
}
注意：这个配置必须写在远程环境的设置里，本地设置无效。同时建议升级 Remote-SSH 插件到最新版，并启用 "remote.ssh.useLocalServer": true 减少代理层延迟。
最常被忽略的一点：即使你把 rightClickBehavior 设对了，只要剪贴板里还躺着上万行日志，或者某个插件正偷偷监听右键事件，粘贴照样卡。优化不是单点操作，而是三者缺一不可——配置、剪贴板清理、插件管控。
