QuickJS-NG 在 Windows 终端输出 Unicode 字符乱码问题解析

在 Windows 平台上使用 QuickJS-NG 执行 JavaScript 代码时，开发者可能会遇到一个常见问题：当尝试输出某些 Unicode 字符（如制表符"│"）时，终端显示会出现乱码现象。这个问题看似简单，但实际上涉及多个技术层面的因素。

问题现象

当在 Windows 终端或 VSCode 终端中运行包含特定 Unicode 字符的 JavaScript 代码时，例如：

console.log('│')

输出结果会显示为乱码字符，而不是预期的竖线符号。有趣的是，如果将输出重定向到文件，文件中的内容却是正确的。

技术背景

这个问题本质上与字符编码处理和终端显示机制相关。Windows 系统传统上使用不同于 Unix-like 系统的编码方案（如 CP437 或 CP936），而现代应用程序则普遍采用 UTF-8 编码。QuickJS-NG 在处理字符输出时需要正确协调这些编码差异。

根本原因

经过技术分析，这个问题主要源于两个关键因素：

1. 文件加载编码处理：QuickJS-NG 在 Windows 平台下读取 JavaScript 源文件时，没有正确处理 UTF-8 编码的源文件，导致特殊字符在解析阶段就已经出现偏差。

2. 终端输出机制：Windows 终端（包括新版 Windows Terminal 和传统 cmd.exe）对 Unicode 字符的支持方式与 Unix-like 系统不同，需要额外的编码转换处理。

解决方案

QuickJS-NG 项目已经通过代码修改解决了这个问题。修复方案主要涉及：

1. 在文件加载阶段明确指定 UTF-8 编码处理
2. 增强终端输出的编码转换逻辑
3. 确保内部字符串处理全程保持编码一致性

开发者应对建议

对于暂时无法升级到修复版本的开发者，可以考虑以下临时解决方案：

1. 使用 ASCII 范围内的替代字符
2. 将输出重定向到文件后再查看
3. 在代码中进行显式的编码转换

总结

字符编码问题一直是跨平台开发中的常见挑战。QuickJS-NG 对此问题的修复体现了对 Windows 平台更好的兼容性支持。开发者在使用类似工具时，应当注意不同平台下的编码差异，特别是在处理国际化内容和特殊符号时。理解这些底层机制有助于快速诊断和解决类似问题。