xshell显示中文日志 日志编码配置方法

在 Xshell 中远程查看 Linux 服务器日志时，如果中文内容变成了一串问号、方框或者毫无规律的乱码，通常不是日志文件损坏，而是终端显示的字符编码与服务器输出的编码不一致。只要将 Xshell 会话的终端编码调整为与日志实际编码相同，重新执行查看命令，中文即可正常显示。这种方法无需修改服务器文件，直接改善阅读体验。

左侧为编码不匹配导致的中文乱码，右侧为配置正确后的正常显示效果

必要的概念很简单：计算机存储文字是一串字节，不同的编码规则（如 UTF-8、GBK）将这串字节解释为不同的汉字。Xshell 作为客户端，需要知道服务器发来的字节流遵循哪种规则，才能正确“翻译”成屏幕上的文字。开始前，请确保你拥有服务器的 SSH 登录权限，并能执行基本的查看命令。

1. 确认日志实际使用的编码

不要一看到乱码就盲目切换 Xshell 的设置。首先需要在服务器端确认生成日志的程序或脚本使用的是哪种字符集。现代 Linux 系统和大多数新应用默认使用 UTF-8，但一些旧系统或特定行业软件可能仍在使用 GBK 或 GB18030。

如果日志是由 Java、Python 或 Web 服务写入的，优先查看该程序的配置文件或启动参数。如果是脚本临时输出，可以检查脚本文件的保存编码。若无法直接查看配置，可以在服务器上执行以下命令获取参考信息：

file -bi /var/log/your-app.log

命令返回结果中的 charset 字段可作为参考，但需注意部分日志可能混合了多种来源的文本。最可靠的依据仍是产生日志的程序配置。假设确认日志为 UTF-8 编码，接下来进入 Xshell 进行设置；若确认为 GBK，则选择对应的中文编码选项。

1. 确认日志实际使用的编码

2. 在会话属性中设置终端编码

1. 在 Xshell 左侧的会话管理器中找到目标服务器连接。如果当前已连接，建议先断开会话，或者保持连接但准备重新执行命令。右键点击该会话，选择【属性】；也可以在已打开的窗口顶部菜单栏点击【文件】，选择【当前会话属性】。

右键点击会话选择属性，或通过文件菜单进入当前会话属性

2. 在弹出的属性窗口左侧设置树中，展开【终端】类别，点击【编码】（部分版本显示为 Encoding）。这里的核心是找到控制终端字符集的下拉菜单。

3. 将编码选项修改为日志实际使用的字符集。对于绝大多数现代服务器，选择【UTF-8】；只有在明确知道旧系统输出为 GBK、GB2312 或 GB18030 时，才选择对应项。请注意，不要混淆【字体】设置和【编码】设置，更换字体只能解决字形缺失导致的方框问题，无法纠正因编码不匹配产生的乱码。

4. 点击【确定】保存设置。如果之前断开了连接，现在重新连接服务器；如果保持连接状态，之前的乱码内容不会自动刷新，需要重新执行查看命令（如 tail、less 或应用自带的日志查询指令）来观察新输出的内容。

为了快速验证设置是否生效，可以执行一条简单的测试命令：

printf '中文编码测试\n'

如果这行文字能清晰显示，说明编码配置正确。此时再打开目标日志文件，中文应能正常阅读。需要注意的是，会话设置通常只影响当前选中的连接，如果有多个服务器使用不同编码，应分别为它们保存独立的会话配置。

3. 日志查看和保存时保持编码一致

在终端编码设置正确后，使用 less -N、tail -f 等命令实时跟踪日志。如果发现历史内容正常，但新写入的中文仍然乱码，需检查写日志的进程是否在重启后改变了编码配置，或者是否有经过转义、压缩的字段混入。

当需要将终端内容记录到本地时，可以使用 Xshell 的【日志】功能。点击菜单栏的【工具】或【文件】，找到【开始记录】或类似选项，选择保存路径。日志文件记录的是会话的输出流，保存后建议使用支持 UTF-8 或其他目标编码的编辑器（如 Notepad++、VS Code）打开查看，不要仅依赖 Windows 记事本，因为记事本有时会自动误判编码。

通过工具或文件菜单开启日志记录，并选择保存路径

建议先开启记录，执行一小段包含中文的测试操作，然后停止记录并用编辑器打开文件，确认中文、时间戳和命令提示符均显示正常。确认无误后，再开启长时间的日志记录。如果终端显示正常但保存的文件乱码，重点检查本地编辑器的打开编码设置；如果两者都异常，则回到会话属性重新核对编码，并彻底关闭重连后再试。

4. 乱码仍未解决时按顺序排查

如果上述步骤后仍有问题，观察乱码的具体形态有助于缩小范围：整段都是问号，可能是源程序在写入前就丢失了字符信息；出现固定的空心方框，可能是当前选择的字体缺少中文字形，尝试在【终端】-【外观】中更换为“宋体”或“微软雅黑”；如果中文变成了有规律的西文符号，通常更像编码不匹配。

在同一会话中执行 locale 命令，检查 LANG、LC_ALL 等环境变量。这些变量反映了服务器程序运行的语言环境，虽然不能直接替代 Xshell 的终端编码设置，但能提供重要线索。例如，若 LANG 显示为 zh_CN.GBK，则 Xshell 端也应尝试选择 GBK 编码。

执行locale命令查看服务器语言环境变量，辅助判断编码

排查时请保持单一变量原则：暂时只调整【终端】里的编码，不要同时改变终端类型、字体、颜色和编码，否则难以判断哪一步生效。若服务器程序明确输出 GB18030 而当前 Xshell 版本无此选项，建议在服务器端将日志转换为 UTF-8，或使用应用支持的导出功能，避免随意选择相近编码导致数据错误。

最后，保留一份原始日志副本，再做任何转换或清理操作。确认中文显示正常后，建议将该会话另存为清晰的名称，例如“生产服务器-UTF8”，并在备注中记录日志来源编码。以后新增连接时，按服务器实际编码单独配置，遇到乱码先核对来源，再调整 Xshell 会话属性，即可高效解决显示问题。