在 Windows 的 cmd 或 PowerShell 中运行 dsh-TUI 时出现中文乱码，通常是三个环节不一致造成的：终端当前代码页不是 UTF-8、dsh-TUI 进程自身的输出编码不是 UTF-8、以及终端渲染字形时使用的字体不支持中文字符。先判断当前代码页和 dsh-TUI 的实际输出，再按顺序调整终端代码页、进程编码和终端软件，基本可以定位并消除乱码。
dsh-TUI 在 Windows 传统控制台中出现中文乱码，主要原因是终端代码页和进程输出编码不一致。处理方向是先运行 chcp 查看当前代码页，再用 chcp 65001 切换到 UTF-8，并设置 PYTHONIOENCODING 或修改配置文件的 encoding 项保证输出源头正确；若仍乱码，建议改用 Windows Terminal 并配置中文字体。这一过程只改变显示和输出编码，不涉及字体渲染原理，也不保证所有命令行工具都能无差异显示。验证时需同时检查界面显示和日志文件。
判断当前代码页与输出编码
先不要改任何配置，打开 cmd 或 PowerShell，运行：
chcp输出会显示类似 活动代码页: 936 或 Active code page: 65001。936 是 GBK，通常处理中文没问题，但如果 dsh-TUI 按 UTF-8 输出，GBK 代码页会把它按本地代码页解释，结果就是显示为乱码或问号。65001 是 UTF-8 代码页，大部分情况下能正确显示 UTF-8 输出，但要注意某些老程序在 65001 下反而有兼容问题。
然后直接运行 dsh-TUI，观察报错信息和界面文本。如果中文部分出现类似 浣犲ソ 或 ä½ å¥½ 的字符，基本可以确定是 UTF-8 字节被 GBK 代码页解码；如果出现方框或空白，则可能是终端缺少中文字体渲染，代码页和编码反而不是主因。
这一步的价值在于区分“输出编码错”和“字形显示不出来”。输出编码错时，乱码字符通常有规律；字形问题往往表现为方块、空白或问号。判断清楚了，后面修哪一层才不会白做。
切换终端代码页为UTF-8
在运行 dsh-TUI 的同一个终端窗口中，执行：
chcp 65001执行后终端会切到 UTF-8 代码页。注意这个命令只对当前窗口生效，关闭窗口后恢复原设置。切完代码页后，不要马上运行 dsh-TUI，建议先重启终端窗口，让新的代码页完整生效。部分 Windows 版本在切换代码页后，已经渲染出来的提示文字仍可能残留乱码，重启一次更干净。
如果切到 65001 之后 dsh-TUI 的中文显示正常了，说明问题确实在代码页。但如果显示还是乱码，可能是进程输出编码本身就不是 UTF-8，或者 Windows 控制台字体没有正确加载中文字形。接下来需要从 dsh-TUI 侧固定输出编码。
修改注册表或配置文件使dsh-TUI输出UTF-8
代码页只是终端这侧的接收方。dsh-TUI 自身以什么编码写入标准输出，同样需要确认。dsh-TUI 通常使用 Python 编写，Python 在 Windows 上默认可能使用 GBK 作为标准输出编码。可以用环境变量强制 Python 使用 UTF-8 输出：
set PYTHONIOENCODING=utf-8在 PowerShell 中写成：
$env:PYTHONIOENCODING="utf-8"设置后再运行 dsh-TUI。注意，这个环境变量只影响当前会话，建议把它持久化到用户环境变量中，避免每次手动设置：
setx PYTHONIOENCODING utf-8如果 dsh-TUI 的配置文件里显式提供 encoding 选项，也需要一并改掉。通用做法是打开 dsh-TUI 的配置文件，找到类似 encoding 或 charset 的字段，改成 utf-8 或 UTF-8。配置位置因版本而异，通常可以在软件启动时看到配置路径，或者在用户主目录下寻找 .dshtui 或 dsh-tui 开头的文件。修改配置后，重启 dsh-TUI 才会生效。
这两步配合起来，是从输出源头保证 dsh-TUI 写出的字节确实是 UTF-8，而不是 GBK。完成后再结合前面的 chcp 65001，大多数乱码问题都能解决。
使用Windows Terminal替代传统控制台
如果上述方法都做了，中文仍然显示异常，可以考虑换成 Windows Terminal。Windows Terminal 对 Unicode 和字体的支持比传统 cmd 控制台更稳定，遇到乱码的概率更低。
安装 Windows Terminal 后，先打开它，选择“设置”里的配置文件，找到“外观”或“配置文件”里的字体选项。建议把字体改为支持中文的等宽字体，例如 Sarasa Mono SC 或 YaHei Mono，或者使用系统的 Microsoft YaHei UI。步骤通常如下：
- 在 Windows Terminal 顶部点击下拉箭头，选择“设置”。
- 打开包含 dsh-TUI 所用 shell 的配置文件，比如 PowerShell 或 Cmd。
- 在“外观”中找到“字体”或“字体名称”，替换为中文字体。
- 如果仍乱码，就在该配置文件的“命令行”部分，或打开 shell 后手动执行
chcp 65001。
Windows Terminal 的代码页仍然从底层 shell 继承，所以进入 shell 后还是建议确认代码页已经是 65001。但相比传统控制台，字体渲染问题更少，也不会因为旧版 conhost 的渲染机制导致汉字缺笔或方块。
验证中文显示与日志记录
修复配置后，需要用实际命令验证是否真的恢复正常。先运行：
chcp确认输出是 65001。然后运行 dsh-TUI，输入一条会返回中文结果的命令，例如查看状态或帮助信息。观察界面中的中文标题、按钮、菜单和返回内容是否完整显示，不再出现问号、方块或乱码。
日志文件也要检查。dsh-TUI 通常会把运行记录写入日志文件，默认编码可能是 UTF-8。用记事本打开日志，如果文件内容以 UTF-8 保存，会在编码下拉框中显示“UTF-8”；如果显示为 ANSI 且中文正常，说明进程输出的是 GBK，而界面之前乱码是因为终端代码页不匹配，这时可以考虑是否需要把日志也统一成 UTF-8。若要统一，可以在配置文件中增加或修改日志编码选项，例如 log_encoding = utf-8。
验证时建议同时走一遍常见操作，包括启动、查询、退出，并确认退出提示和错误提示都没有乱码。如果所有显示都正常，一般就可以继续使用了。注意，这些修改只保证 dsh-TUI 在 UTF-8 环境下正常工作，其他依赖 GBK 编码的传统工具可能会在 65001 代码页下出现新的乱码，需要结合具体环境权衡是否切换系统默认代码页。