VSCode调试C程序时Debug Console无法正常显示UTF-8中文

在macOS环境下，使用VSCode的cppdbg调试器（搭配lldb）调试C程序时，Debug Console无法正确解析UTF-8中文输出，只会显示十六进制转义序列；但直接在终端运行编译后的可执行文件，中文显示正常。

最小复现代码 #

#include <stdio.h>

int main(void)
{
    printf("中文测试\n");
    return 0;
}

输出情况 #

• 预期输出：

中文测试

• Debug Console实际输出：

\xe4\xb8\xad\xe6\x96\x87\xe6\xb5\x8b\xe8\xaf\x95

环境信息 #

• 操作系统：macOS 26.1 (25B78)
• VSCode版本：最新稳定版
• 调试器：cppdbg（C/C++官方扩展）+ lldb

已尝试但无效的操作 #

• 将终端和系统区域设置为UTF-8
• 确保源文件以UTF-8格式保存
• 添加编译参数-finput-charset=UTF-8和-fexec-charset=UTF-8
• 在VSCode设置中配置"terminal.integrated.env.*": { "LANG": "en_US.UTF-8" }
• 添加gdb字符集配置命令：

set charset UTF-8
set target-charset UTF-8
set host-charset UTF-8

可行解决方案 #

方案1：切换调试输出终端 #

修改.vscode/launch.json中的console字段，将输出从默认的internalConsole（即Debug Console）切换到集成终端或外部终端：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C/C++: clang 编译调试当前文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "lldb",
            "console": "integratedTerminal" // 可选值：integratedTerminal / externalTerminal
        }
    ]
}

集成终端和外部终端都能正确解码UTF-8中文，可根据习惯选择。

方案2：配置lldb输出编码 #

在launch.json中添加setupCommands，强制lldb使用UTF-8编码输出：

{
    "version": "0.2.0",
    "configurations": [
        {
            // 保留原有其他配置项
            "setupCommands": [
                {
                    "text": "settings set target.output-encoding utf-8",
                    "ignoreFailures": true
                },
                {
                    "text": "settings set target.input-encoding utf-8",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

该配置会让lldb以UTF-8格式输出内容，Debug Console就能正确解析显示中文。

方案3：尝试C/C++扩展预览版 #

部分编码解析问题可能在扩展的预览版中已修复，可在VSCode扩展市场中找到C/C++扩展，切换到Insiders版本尝试。

同类问题参考 #

Stack Overflow上有一个未解决的同类问题，内容翻译为：

如何在VSCode控制台中显示解码后的字符串或Unicode？

内容的提问来源于stack exchange，提问作者Sab1e