xshell乱码怎么办解决办法

在 Windows 电脑上使用 Xshell 连接 Linux 服务器时，终端输出的中文变成无意义字符或显示为方框，会严重影响操作效率。这通常是因为客户端的解码方式与服务器输出的字符集不匹配，或者本地缺少对应的中文字体支持。通过准确查询远端环境并调整 Xshell 会话属性，可以快速恢复正常的中文显示，且不影响服务器上的原始文件。

Xshell 会话属性界面，展示终端编码和外观字体设置入口

1. 选中出现乱码的会话，记下原设置

在 Xshell 中切换到出现乱码的连接标签，确认当前的服务器和登录用户。首先需要区分故障类型：是中文变成了乱码符号，还是只显示空心方框，亦或是无法输入中文。本文主要解决终端输出内容的显示问题。

点击菜单栏的【文件】→【打开】，在会话列表中仅选中这条出问题的服务器记录，点击【属性】。在左侧导航栏选择【终端】，查看并记下当前的【编码】设置；接着查看【外观】中的字体配置。建议将原始的编码选项、亚洲字体设置以及会话名称记录在案，以便后续对比或还原。

注意要编辑实际用于连接的特定会话，而不是修改默认会话模板，否则可能影响其他未配置的连接。在属性窗口中暂不做修改，先回到已连接的终端界面查询远端环境。

2. 查询远端字符集，确定要匹配的编码

在 Linux 的 Bash 命令提示符后，依次输入以下两条命令：

locale charmap
locale

第一条命令 locale charmap 直接返回当前 locale 使用的字符集名称；第二条命令 locale 列出详细的 locale 环境变量。这些命令仅用于查看信息，不会修改系统语言或文件内容。请确保在远端服务器的提示符下执行，而非 Xshell 的本地命令行。

如果 locale charmap 返回 UTF-8，且产生乱码的程序也按 UTF-8 输出，则后续步骤将围绕 UTF-8 展开。需要注意的是，LANG 变量中的语言地区标识（如 en_US 或 zh_CN）不影响字符集判断，关键在于字符集部分。即使远端使用英文语言环境，只要字符集是 UTF-8，就能正常显示中文。

同时观察是否有 locale 警告信息。如果提示环境配置无效，或返回的字符集与管理员提供的标准不一致，应先确认远端的实际配置。此外，终端环境是 UTF-8 并不代表磁盘上的所有旧日志都是 UTF-8。若只有特定文件或程序乱码，需确认其自身的输出编码，再决定 Xshell 如何匹配。对于明确使用 GBK、Big5 等其他编码的环境，应选择对应的编码选项，不可强行套用 UTF-8。

2. 查询远端字符集，确定要匹配的编码

3. 在会话属性中设置对应编码

再次进入【文件】→【打开】，选中该会话并点击【属性】，选择左侧的【终端】。在【编码】下拉列表中，根据第二步确认的结果进行选择。如果是 UTF-8 环境，请选择【Unicode (UTF-8)】，然后点击【确定】。

在会话属性的终端设置中选择 UTF-8 编码

这一步改变的是 Xshell 对接收到的终端字符流的解释方式，服务器上的原始文件编码不会因此改变。设置生效后，应观察新产生的输出内容；已经存在于滚动缓冲区中的历史乱码不会自动恢复，不能作为判断修复成功的唯一依据。

虽然标准工具栏也有【编码】按钮可用于临时切换，但为了确保后续每次连接都能自动应用正确配置，建议以会话属性中的设置为准。如果在调试过程中使用了工具栏切换，最后务必回到会话属性中核对并保存最终值。

若实际环境使用其他中文编码（如 GBK），请在编码列表或工具栏的【更多】区域寻找对应选项。每次只改变一项设置，并重新输出已知内容进行比对。仅凭几个可读汉字不足以证明完全匹配，还需检查标点、数字及整段语句的通顺性。

4. 输出固定文字，验证 UTF-8 显示

针对确认为 UTF-8 的环境，在远端 Bash 中输入以下命令。该命令仅包含 ASCII 字符，避免了复制粘贴中文时可能引入的编码差异：

printf '\344\270\255\346\226\207\346\243\200\346\237\245\n'

这行命令按指定的 UTF-8 字节序列输出文字并换行，预期显示结果为四个汉字：“中文检查”。它只向终端发送数据，不创建文件，也不修改远端语言配置。

使用 printf 命令验证 UTF-8 编码显示效果

如果新的一行能完整清晰地显示“中文检查”，说明当前终端能够正确解码并显示这组 UTF-8 字节。此时，再重新执行原先发生乱码的查看操作，检查新生成的内容。不要仅依赖屏幕上方残留的旧行进行判断。

如果固定测试文字显示正常，但某份旧日志仍然乱码，优先核查该日志文件的原始编码或生成程序的设置。此时继续更换整个会话的编码可能会影响其他正常输出。应保留原文件，在明确源编码后再决定是否转换副本，切勿将转换失败的内容覆盖回原文件。

5. 中文仍显示方框时，单独调整亚洲字体

如果编码匹配正确，但中文位置仍然显示为空心方框，说明本地缺少对应的字形支持。回到该会话的【属性】→【外观】，找到【亚洲字体】（英文界面为 Asian Font）。此项专门控制中文等非 ASCII 字符的字体，与普通【字体】项分开设置。

从本机已安装的字体列表中选择一种支持中文的字体，例如“宋体”或“微软雅黑”，并根据阅读习惯设置字号，点击【确定】。普通 ASCII 字体可保持原值，以减少变量干扰。

回到终端，再次运行第四步的固定命令，检查新输出的四个汉字。调整字体只能解决字形渲染问题，无法纠正因编码错误导致的乱码。因此，必须先完成编码匹配，再处理缺字问题。若本机没有合适的中文字体，需先在 Windows 系统中安装相应语言支持组件，再回来验证。

需注意，如果只是无法输入中文，而现有中文输出显示正常，则应检查 Windows 输入法设置。Xshell 的输出编码选项不负责安装或管理中文输入组件。

6. 保存这条会话，重连检查设置是否保留

最后，再次进入该会话的属性页面，确认【终端】中的编码和【外观】中的亚洲字体均为刚才验证有效的值，点击【确定】保存。待远端正在执行的任务正常结束后，断开连接，通过【文件】→【打开】选择同一条会话重新连接。

重新登录后，再次运行“中文检查”的固定输出命令，并查看原先发生乱码的实际业务内容。当固定文字显示完整、原问题内容按其正确编码清晰显示、且重新连接后配置依然生效时，才算彻底解决了乱码问题。

重新连接会话后中文显示正常且配置保留

保留这条已验证的会话记录，并备注远端字符集和采用的编码方案。后续仅在服务器环境发生变化时才需调整。如果某个文件在传输到终端之前就已经损坏或被错误转换，客户端的显示设置无法恢复丢失的字符，此时需从原始文件或备份中进行排查。