iTerm2在Mac上无法粘贴中文怎么办？

Question

问题：在使用iTerm2时，从剪贴板粘贴中文内容经常出现乱码或无法正常输入，尤其是在远程SSH连接Linux服务器时尤为明显。该问题通常与终端字符编码设置、输入法兼容性或iTerm2版本有关。尽管系统其他应用可正常复制粘贴中文，但在iTerm2中粘贴时内容丢失或显示为问号、方框等符号，严重影响开发效率。如何配置iTerm2及系统环境以支持稳定可靠的中文粘贴？

Answer 1

1. 问题现象与初步排查

在使用iTerm2时，从剪贴板粘贴中文内容经常出现乱码或无法正常输入，尤其是在远程SSH连接Linux服务器时尤为明显。该问题通常表现为：

• 粘贴的中文字符显示为???、方框（□）或乱码符号
• 部分汉字被截断或编码错误
• 本地终端可正常显示中文，但通过SSH连接后粘贴失败
• 系统其他应用（如浏览器、文本编辑器）复制粘贴正常，唯独iTerm2异常

初步判断该问题并非系统全局性编码故障，而是终端模拟器与远程环境之间字符处理链路中的某个环节出现了不一致。

2. 根本原因分析：字符编码与传输链路

iTerm2作为终端模拟器，其与远程Linux服务器之间的通信依赖于SSH协议，而整个中文粘贴流程涉及多个层级的字符编码处理：

1. 剪贴板数据来源：macOS剪贴板可能以UTF-8或其他编码格式存储文本
2. iTerm2解码行为：是否正确识别并解析剪贴板中的Unicode内容
3. SSH传输过程：是否保持原始字节流完整性
4. 远程Shell环境：bash/zsh对输入字符的解析方式
5. 远程系统locale设置：影响字符解释和输出渲染

任一环节未正确配置UTF-8支持，均可能导致中文粘贴失败。

3. iTerm2本地配置优化

确保iTerm2自身启用完整的UTF-8支持：

配置项	推荐值
Preferences → Profiles → Terminal → Character Encoding	Unicode (UTF-8)
Preferences → Advanced → International	Prefer UTF-8 for clipboard operations
Preferences → Keys → Key Mappings	检查是否有冲突快捷键影响粘贴（如Cmd+V）
Preferences → Profiles → Text → Non-ASCII Font	选择支持中文的字体（如PingFang SC, Hiragino Sans GB）

此外，建议更新至最新稳定版iTerm2（≥3.5），避免旧版本存在的剪贴板API兼容性缺陷。

4. 远程Linux服务器环境配置

远程端必须具备完整的UTF-8 locale支持。执行以下命令检查当前设置：

locale
echo $LANG
echo $LC_ALL

若输出中包含en_US、C或为空，则需配置UTF-8 locale。操作步骤如下：

1. 生成UTF-8语言环境（Debian/Ubuntu）：
   sudo dpkg-reconfigure locales → 勾选zh_CN.UTF-8或en_US.UTF-8
2. 设置默认LANG：
   sudo update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
3. 或在用户shell配置文件中添加：
   export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

重启会话后验证locale命令输出应全为UTF-8前缀。

5. SSH客户端与服务端协同配置

SSH协议本身不影响字符编码，但OpenSSH客户端可通过配置强制传递正确的环境变量：

# 编辑本地 ~/.ssh/config
Host *
    SendEnv LANG LC_*

同时确认远程/etc/ssh/sshd_config中允许接收环境变量：

AcceptEnv LANG LC_CTYPE LC_NUMERIC LC_TIME LC_COLLATE LC_MONETARY LC_MESSAGES
AcceptEnv LC_PAPER LC_NAME LC_ADDRESS LC_TELEPHONE LC_MEASUREMENT
AcceptEnv LC_IDENTIFICATION LC_ALL

修改后需重启sshd服务：sudo systemctl restart sshd。

6. 输入法与粘贴行为深度调优

某些第三方输入法（如搜狗、百度输入法）在向终端注入文本时采用非标准接口，导致iTerm2接收异常。建议：

• 临时切换为系统自带拼音输入法测试
• 关闭“智能粘贴”功能（iTerm2 Preferences → Advanced → Smart Placement）
• 启用“Escape non-ASCII input”选项防止特殊字符转义
• 使用Cmd+Shift+V而非右键菜单粘贴，绕过部分GUI层干扰

还可通过AppleScript调试剪贴板内容真实性：

osascript -e 'the clipboard'

7. 完整诊断流程图

graph TD A[复制中文文本] --> B{iTerm2能否正常粘贴?} B -- 否 --> C[检查iTerm2字符编码设置] C --> D[确认是否为UTF-8] D -- 否 --> E[更改为Unicode UTF-8] D -- 是 --> F[检查远程locale设置] F --> G[LANG/LC_*是否为UTF-8?] G -- 否 --> H[配置远程系统locale] G -- 是 --> I[检查SSH SendEnv/AcceptEnv] I --> J[验证剪贴板实际内容] J --> K[尝试更换输入法] K --> L[问题是否解决?] L -- 是 --> M[完成] L -- 否 --> N[升级iTerm2或使用Alacritty替代测试]

8. 验证与自动化脚本

编写一键检测脚本验证全流程状态：

#!/bin/bash
echo "=== Local Clipboard Test ==="
echo "Clipboard content:"; osascript -e 'the clipboard' 2>/dev/null | hexdump -C

echo "=== iTerm2 Environment ==="
echo "Terminal encoding: $(defaults read com.googlecode.iterm2 NSStringEncoding)"

echo "=== Remote Locale Status ==="
locale | grep UTF-8 || echo "Warning: No UTF-8 detected"

echo "=== SSH Env Forwarding ==="
grep -q "SendEnv" ~/.ssh/config && echo "SendEnv configured" || echo "SendEnv missing"

运行该脚本可快速定位瓶颈所在层级。