Skip to content

VSCode 使用 CMake 时输出日志乱码解决方法

在使用 VSCode 的内置 CMake 功能进行编译和运行时,Output 面板可能会出现中文乱码的问题。这个问题通常与输出日志的编码格式设置有关。


🛠️ 解决方法

方法一:通过设置界面修改编码

  1. 打开 VSCode 设置(快捷键:Ctrl + ,)。

  2. 在搜索框中输入:output

  3. 找到并修改以下设置项:

    • CMake: Output Log Encoding
  4. 将其设置为:

    • utf-8gbk
    • 哪个编码显示正常就选哪个

💡 建议优先尝试 utf-8,如果仍乱码,再改为 gbk

示例截图:

搜索并修改 CMake: Output Log Encoding 设置项
CMake: Output Log Encoding


方法二:修改工作区设置文件

  1. 打开工作区的 .vscode/settings.json 文件(若无请手动创建)。
  2. 添加以下内容:
json
{
    "cmake.outputLogEncoding": "utf-8"
}

同样,如果使用 utf-8 仍乱码,可以改成 gbk

json
{
    "cmake.outputLogEncoding": "gbk"
}

⚠️ 注意事项

  • Windows 系统的默认编码可能是 gbk,尤其是中文系统。
  • Linux/macOS 一般默认使用 utf-8
  • 此设置只影响 CMake 输出日志的编码,不会影响源码文件或终端编码。