mac上zsh终端粘贴卡顿主因是括号粘贴模式或插件干扰，可临时禁用zle_bracketed_paste验证，注释语法高亮等插件排查，并调整terminal/iterm2粘贴设置为normal模式。
mac 上 zsh 终端粘贴文本卡顿，通常不是 zsh 本身的问题，而是终端应用（terminal.app 或 iterm2）与 shell 配置协同不当导致的响应延迟。最常见诱因是「粘贴检测机制」被错误触发，或插件在粘贴瞬间执行了大量同步操作。
检查并关闭 zsh 的粘贴检测（bracketed paste mode）
zsh 默认启用 bracketed paste mode（带括号粘贴模式），它本意是让 shell 区分“用户手动输入”和“批量粘贴”，从而避免粘贴含换行/特殊字符的代码时误执行。但某些旧版插件或自定义配置会干扰该机制，导致粘贴前卡顿 0.5–2 秒。
临时验证是否为此原因：在终端中运行
bindkey -v | grep bracket
若看到类似 ^[[200~ 相关绑定，说明已启用。可临时禁用测试：
unset zle_bracketed_paste
如果粘贴立刻变快，说明问题在此。永久解决需在 ~/.zshrc 中顶部附近添加：
unset zle_bracketed_paste
排查高开销插件在粘贴时的干扰
部分 zsh 插件（尤其是语法高亮类）会在每次输入变化时实时重绘，而粘贴一大段文本相当于连续触发数十次渲染，造成明显卡顿。典型“嫌疑插件”包括：
- zsh-syntax-highlighting：默认开启实时高亮，大段粘贴时 CPU 占用飙升
- zsh-autosuggestions：逐字符匹配历史命令，长文本粘贴易阻塞
- Powerlevel10k 主题的 instant_prompt：若未正确配置，粘贴时可能反复刷新提示符
建议做法：打开 ~/.zshrc，把这几行暂时注释掉（加 #），然后运行 source ~/.zshrc 测试。确认卡顿消失后，再逐个启用、观察表现。
调整终端应用设置（以 Terminal.app 和 iTerm2 为例）
终端本身也有影响粘贴流畅度的关键选项：
- Terminal.app：菜单栏 → 终端 → 偏好设置 → 描述文件 → （选中当前描述文件）→ 高级 → 取消勾选「在粘贴前将文本拆分为多行」
- iTerm2：菜单栏 → iTerm2 → 设置 → Profiles → Keys → 滚动到底部「Paste」区域 → 将「Paste mode」改为 Normal（而非 Bracketed）
这两项改动能绕过终端层面对粘贴内容的预处理，对含大量换行或 ANSI 序列的文本尤其有效。
避免粘贴时触发补全或路径展开
有时卡顿发生在粘贴后按回车前——其实是 zsh 正在尝试对粘贴内容做路径补全或 glob 展开（比如粘贴了 ls ~/Docu*）。可临时禁用交互式补全：
bindkey '^i' self-insert
这会把 Tab 键变成纯输入键，不触发补全。如需长期使用，加到 ~/.zshrc；日常调试时直接执行即可验证效果。
