Trae终端中文显示为乱码（???）的常见原因及解决方法

Question

Trae终端（应为“Tera Term”）中文显示为“???”，是Windows下串口/SSH调试中高频问题。常见原因包括：①终端字符编码未设为UTF-8或GBK（如默认ANSI）；②目标设备（如嵌入式Linux）未正确配置locale，LANG环境变量非中文编码；③串口通信中未启用宽字符支持或字体不支持中文；④Tera Term自身字体设置为不支持CJK的西文字体（如Courier New）。解决方法依次为：在Tera Term → Setup → Terminal中勾选“Use UTF-8 encoding”并选择支持中文的等宽字体（如“Microsoft YaHei Mono”或“NSimSun”）；在Linux端执行`locale -a | grep zh`确认语言包存在，并设置`export LANG=zh_CN.UTF-8`；必要时安装`locales`并生成中文locale。若仍异常，可临时用`echo -e "\xE4\xB8\xAD\xE6\x96\x87"`验证UTF-8字节流是否被正确解析。

Answer 1

```html

一、现象定位：Tera Term 中文显示为 “???”，本质是字符解码链路断裂

该问题并非单一配置错误，而是终端（Client）、传输通道（Serial/SSH）、远端系统（Target OS）三端编码协同失效的典型表现。在嵌入式调试中，80% 的“中文乱码”实际源于 UTF-8 字节流被 ANSI 解码器误读，而非内容本身损坏。

二、分层归因分析（由浅入深）

1. 客户端渲染层：Tera Term 字体不支持 CJK 字形，或未启用 UTF-8 解码开关；
2. 通信协议层：串口无宽字符协商机制（如未启用 stty iutf8），SSH 会话未透传 locale 环境变量；
3. 操作系统层：Linux 目标系统未安装中文 locale 数据，LANG 为空或设为 C；
4. 内核与驱动层（进阶）：某些精简版嵌入式 Linux 内核禁用 CONFIG_NLS_UTF8，导致 cat /proc/sys/kernel/console_loglevel 级别日志无法解析 UTF-8；

三、验证路径与诊断命令表

验证环节	Windows（Tera Term）	Linux Target	预期输出
编码设置检查	Setup → Terminal → ✅ Use UTF-8 encoding	locale	LANG=zh_CN.UTF-8
字体可用性	Setup → Font → 选择 Microsoft YaHei Mono	locale -a | grep zh_CN.utf8	应返回 zh_CN.utf8
原始字节验证	发送：\xE4\xB8\xAD\xE6\x96\x87	echo -e "\xE4\xB8\xAD\xE6\x96\x87"	终端显示“中文”，非“???”

四、系统性修复流程（Mermaid 流程图）

flowchart TD
    A[启动 Tera Term] --> B{是否勾选 'Use UTF-8 encoding'?}
    B -- 否 --> C[Setup → Terminal → 勾选]
    B -- 是 --> D{字体是否支持中文?}
    D -- 否 --> E[Setup → Font → 选 Microsoft YaHei Mono]
    D -- 是 --> F[建立 SSH/串口连接]
    F --> G[登录后执行 locale]
    G --> H{LANG=zh_CN.UTF-8?}
    H -- 否 --> I[export LANG=zh_CN.UTF-8
若失败则 apt install locales && locale-gen zh_CN.UTF-8]
    H -- 是 --> J[测试 echo -e \"\\xE4\\xB8\\xAD\\xE6\\x96\\x87\"]
    J --> K{显示“中文”?}
    K -- 否 --> L[检查 stty -a | grep iutf8
串口需：stty iutf8]
    K -- 是 --> M[✅ 全链路 UTF-8 协同完成]

五、高阶注意事项（面向 5+ 年从业者）

• SSH 连接时，OpenSSH 客户端默认不转发 LANG，需在 ~/.ssh/config 中添加：SendEnv LANG LC_*，服务端 /etc/ssh/sshd_config 启用 AcceptEnv LANG LC_*；
• BusyBox 环境下 locale 命令常被裁剪，可直接写入 /etc/profile：export LANG=zh_CN.UTF-8 并确保 /usr/share/i18n/charmaps/UTF-8.gz 存在；
• Tera Term v5.0+ 支持自动检测 BOM，但串口无 BOM，故必须显式启用 UTF-8 模式；
• 若使用 MinGW/MSYS2 编译的 Tera Term 衍生版，需确认其链接的 iconv 库支持 GBK→UTF-8 双向转换；

六、不可忽视的兼容性陷阱

部分国产嵌入式 SoC（如全志 H3/H6）U-Boot 阶段控制台默认使用 GB2312，而 Linux kernel 启动后切换至 UTF-8 —— 导致早期 bootlog 中文正常，login 后变 ???。此时需统一内核参数：console=ttyS0,115200n8 earlyprintk=serial,0x01c28000,115200n8 loglevel=8 并在 /etc/default/grub 中追加 GRUB_CMDLINE_LINUX_DEFAULT="... utf8"。

```