Qt Creator 底下那个“控制台”是假的:一次 Windows 中文乱码排查实录

前段时间写 loghandler,需求说出来特别简单:console 里看的、调试输出里看的、实际落盘的内容,编码得一致。就这么点要求,被中文乱码折腾了好久。各种组合来回试过,才定位到元凶不是代码,而是观察工具本身:Qt Creator 底部那个长得像控制台的窗格,其实不是控制台,是 IDE 重定向、转述过的 output。 先把结论放在最前面: 那个窗格的大名是"应用程序输出"(Application Output)。Qt Creator 运行程序时不给它开控制台,而是用管道接住进程的 stdout/stderr,读出字节后由 IDE 自己解码再显示。它是转述者,不是终端。 所以 SetConsoleOutputCP() 对它完全无效——那是设置真控制台渲染解码的 API,而这条链路上压根没有"控制台渲染"这一环。 printf 的字节流会被窗格按系统本地代码页(中文 Windows 即 GBK)固定解码。源文件是 UTF-8 的话,printf 直出中文在这个窗格里必乱,怎么设置都救不回来。 更迷惑的是 qDebug 走的是另一条 Unicode 通道,在窗格里永远正常。“qDebug 好的、printf 坏的"这个组合,会把你引向一连串错误归因。 以下实测基于 Qt 5 + Qt Creator(起码大版本 5 是这样)。只要 Creator 还是"管道重定向 + 自己解码"这个架构,这个坑就大概率还在;不同版本的解码细节可能变化,所以文末的验证方法比这里的结论更重要。 症状:qDebug 正常,printf 乱码 程序里两种输出混用——qDebug 做调试,printf/fprintf 是老代码或第三方库。在 Qt Creator 里一跑:qDebug 的中文正常,printf 的中文全是 涓枃娴嬭瘯。 这类乱码不用背规律,看长相查表就能反推出"输的什么码、解的什么码”。GitHub 上这份 unicode-encoding-error-table 按外观特征收录了常见错法,涓枃娴嬭瘯 这种"古文码"就是 UTF-8 字节被按 GBK 解读——3 字节的汉字被拆成 2+1 错配,长度都对不上,看起来自然乱得不像话。反过来说,看到它就知道:输出端发的是 UTF-8,解码端在用 GBK。 ...

2026年8月17日 · 2 min