iTerm2启动发送文本重复执行 zsh多终端启动命令异常排查

该现象是终端启动文本发送时序与zsh初始化流程不匹配导致的，和ohmyzsh、starship、系统级zsh配置、用户目录下的zsh配置内容均无直接关联：

• 所有终端的「启动时发送文本」功能，本质是在创建伪终端（PTY）后，直接向PTY输入流写入预设内容，默认不会等待shell完成初始化进入交互等待状态
• zsh启动过程中会先读取输入缓冲区的内容做初步回显，等初始化完成加载ZLE（zsh内置行编辑器）后，会再次读取缓冲区内容作为正式交互命令解析执行，预设的启动文本刚好落在这个时间窗口内，就会出现「先显示一次文本，随后命令再次执行」的重复现象
• 该问题是全终端通用的时序问题，因此在iTerm2、VSCode终端、Mac原生终端上只要配置了提前发送的启动文本，都会复现相同故障。

你当前.zprofile和.zshrc中的PATH配置、pyenv配置、iTerm2 shell集成加载逻辑均不会触发该问题，注释系统级zsh配置无法解决是因为没有触碰到时序冲突的核心原因。

根据使用场景选择对应方案即可：

• 优先方案：放弃使用终端自带的启动文本配置，将需要在会话启动时执行的命令，直接写到~/.zshrc（交互式shell场景）或~/.zprofile（登录shell场景）的末尾，完全绕开终端发输入的时序问题，是兼容性最好、最稳定的方案。
• iTerm2专属修复：你已经在.zshrc中加载了iTerm2 Shell Integration脚本，直接打开对应Profile的设置页，在「Send text at start」配置项下方，勾选Wait for shell to finish starting up before sending text选项，让iTerm2感知shell初始化完成状态，等shell进入交互就绪阶段后再发送预设文本，即可彻底解决重复执行问题。
• 无shell集成感知能力的终端（VSCode终端、Mac原生终端等）：如果必须使用终端自带的启动文本配置，不要直接写入裸命令，给命令增加短延迟避开zsh初始化窗口即可，用户对0.1~0.3秒的延迟完全无感知。例如需要启动时执行neofetch，就将启动文本设置为：

sleep 0.2 && neofetch

如果需要执行切换目录这类需要作用于当前交互shell的操作，可以将启动文本设置为：

print -z "cd ~/your/target/path"

该命令会在zsh初始化完成后，把目标命令写入命令行队列，不会触发重复读取问题。

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