Mac终端（Iterm2/Terminal）编辑历史命令时文本错乱求助

zsh配置相关修复 #

• 排查干扰插件：打开~/.zshrc，临时注释掉自定义的历史扩展、提示符类插件的加载代码，重启终端测试是否恢复正常。
• 重置按键绑定：执行bindkey -d恢复zsh默认按键配置，再运行source ~/.zshrc生效，验证光标定位是否正常。
• 修复提示符转义：如果自定义了PS1提示符，必须用%{...%}包裹所有非打印字符（比如颜色代码），避免终端计算字符宽度出错。举个例子，错误写法PS1="\033[32m%n@%m\033[0m "要改成PS1="%{\033[32m%}%n@%m%{\033[0m%} "。

终端应用设置调整 #

iTerm2 3.3.6 #

• 修正终端类型：打开偏好设置 > 配置文件 > 终端，勾选「将终端类型报告为xterm-256color」，同时确保「终端仿真」里的「启用光标报告」已开启。
• 重置应用配置：执行defaults delete com.googlecode.iterm2（注意会清空所有iTerm2设置，建议先备份），重启后测试。
• 关闭智能光标定位：在偏好设置 > 高级里搜索「Smart Cursor Position」，设置为「否」。

Terminal 2.12.7 #

• 修改终端声明：进入偏好设置 > 描述文件 > 高级，把「声明终端为」改成xterm-256color。
• 测试默认配置：新建一个空白描述文件，切换过去使用，排除自定义配置的干扰。

系统与字体调整 #

• 重建终端缓存：执行killall -HUP Terminal和killall -HUP iTerm2，强制终端重启并重建缓存。
• 切换默认字体：换成系统自带的Menlo等宽字体，避免使用非等宽或特殊编码字体，这类字体容易导致字符宽度计算错误。

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