【Clion】【文件编码】Clion内置控制台中文字体乱码的解决方案及编码格式调整

1. 问题描述

在使用Clion时，在保证文件编码，项目编码，属性文件的默认编码等均为UTF-8的情况下，当代码输出中存在中文字符时，内置控制台显示的输出为乱码。

2. 尝试解决方案

在CLion中解决内置控制台乱码问题，主要需要统一项目编码、控制台编码和系统环境编码。以下是具体步骤：
2.1 第一次尝试解决

1. 检查并设置项目文件编码（执行后未解决问题）

CLion的文件编码设置可能影响控制台输出的编码格式：

• 打开 File > Settings（Windows/Linux）或 CLion > Preferences（macOS）。
  
• 进入 Editor > File Encodings。
  
• 确保以下选项均设置为 UTF-8：
  
  
  
  • Global Encoding（全局编码）
    
  • Project Encoding（项目编码）
    
  • Default encoding for properties files（属性文件默认编码）
    
  
  
• 点击 OK 保存。
  

2. 修改控制台输出编码（执行后未解决问题）

如果项目编码正确但控制台仍乱码，需单独设置控制台编码：

• 打开运行/调试配置：点击顶部菜单栏 Run > Edit Configurations。
  
• 在左侧列表中选择你的运行配置（如 main 或自定义配置）。
  
• 在右侧 Configuration 标签页中，找到 Environment 区域，点击 Environment variables 右侧的 ...。
  
• 点击 + 添加环境变量：
  
  
  
  • Name 输入 LC_ALL（Linux/macOS）或 PYTHONUTF8（Windows，针对部分场景）
    
  • Value 输入 en_US.UTF-8（强制UTF-8编码）
    
  • （Windows可选）添加 CONSOLE_ENCODING 并设置为 UTF-8
    
  
  
• 保存配置并重新运行程序。
  

3. 针对Windows系统的额外设置（执行后未解决问题）

Windows默认控制台编码为GBK，可能与CLion的UTF-8冲突，需额外处理：

• 打开CLion的VM配置文件：
  
  
  
  • 点击 Help > Edit Custom VM Options。
    
  • 在打开的文件中添加一行：Dfile.encoding=UTF-8
    
  • 保存并重启CLion。
    
  
  

• （可选）修改Windows系统控制台编码：
  
  
  
  • 按下 Win + R，输入 cmd 打开命令提示符。
    
  • 执行命令 chcp 65001（切换到UTF-8编码）。
    
  • 重启CLion后尝试运行程序。
    
  
  

4. 检查代码中的输出编码（未手动指定输出编码，故未执行）

如果程序中手动指定了输出编码（如使用setlocale等函数），可能导致冲突：

• 确保代码中未强制设置与UTF-8冲突的编码（如GBK）。
  
• 示例：若使用C语言的printf输出中文，需确保代码文件为UTF-8编码，且未通过setlocale(LC_ALL, "zh_CN.GBK")强制设置GBK。
  

5. 针对CMake项目的补充设置（未尝试）

如果是CMake项目，可在CMakeLists.txt中添加编码相关编译选项：

1. # 确保编译器使用UTF-8编码处理源文件
2. if (MSVC)
3.     # Visual Studio编译器
4.     add_compile_options("/source-charset:utf-8")
5. else()
6.     # GCC/Clang编译器
7.     add_compile_options(-finput-charset=UTF-8)
8. endif()

复制代码

通过以上步骤，基本可以解决CLion内置控制台的乱码问题。核心原则是：确保项目文件编码、控制台环境编码、程序输出编码三者统一为UTF-8。如果是Linux/macOS系统，通常只需完成前两步即可；Windows系统可能需要额外配置系统或VM选项。
2.2 执行了第一次尝试中的1,2,3方案后，仍未解决，进行第二次尝试

如果前面的步骤仍未解决乱码问题，可以尝试以下更深入的解决方案，针对不同场景进一步排查：
1. 强制CLion控制台编码（针对Java底层配置）（执行后未解决问题）

CLion基于Java开发，其控制台编码可能受Java虚拟机（JVM）参数影响，可直接强制指定：

• 打开 Help > Edit Custom VM Options（如果没有该文件，会提示创建）。
  
• 添加以下两行配置（覆盖默认编码）：
  1. -Dfile.encoding=UTF-8
  2. -Dconsole.encoding=UTF-8

  复制代码
• 重启CLion 使配置生效，重新运行程序测试。
  

2. 针对C/C++程序的特殊处理（执行后成功解决问题，但需要每次指定编码，故以此为切入点）

如果是C/C++程序输出乱码，可能是编译器对字符串常量的编码处理问题：

• 在代码中显式指定输出编码转换（适用于Windows系统）：
  [code]#include #include  // 仅Windows需要int main() {    // 将控制台输出编码设置为UTF-8（Windows特有）    SetConsoleOutputCP(65001);    // 测试输出    std::cout  Tools > Terminal。
  
• 在 Shell path 中，默认可能是内置控制台（如 cmd.exe 或 powershell），可尝试：
  
  
  
  • 若为Windows，切换为 powershell（可能比cmd有更好的UTF-8支持）。
    
  • 勾选 Run with legacy console（仅Windows，兼容旧控制台模式）。
    
  
  
• 重启CLion后测试。
  

4. 检查系统区域设置（Windows关键步骤）（执行后成功解决问题，应该是问题的关键所在，后文叙述原因）

Windows的系统区域设置可能强制覆盖程序编码：

• 打开 控制面板 > 时钟和区域 > 区域。
  
• 进入 管理 标签页，点击 更改系统区域设置。
  
• 勾选 Beta 版：使用Unicode UTF-8提供全球语言支持（Windows 10及以上）。
  
• 点击 确定 并重启电脑，让系统默认编码为UTF-8。
  

5. 清理缓存并重建项目（未尝试）

CLion的缓存可能导致配置未生效：

• 点击 File > Invalidate Caches...。
  
• 勾选 Clear file system cache and local history，点击 Invalidate and Restart。
  
• 重启后，重新构建项目（Build > Rebuild Project）并运行。
  

6. 终极验证：使用外部终端（未尝试）

如果内置控制台始终有问题，可尝试使用系统外部终端验证是否是CLion本身的问题：

• 打开 Run > Edit Configurations。
  
• 在运行配置中，勾选 Run in external terminal（在配置的底部）。
  
• 运行程序，观察系统自带终端（如cmd、powershell、终端）是否显示正常。
  
  
  
  • 若外部终端正常，说明问题出在CLion内置控制台，可暂时使用外部终端，或尝试更新CLion版本。
    
  • 若外部终端也乱码，说明是系统编码或程序本身的问题（回到步骤二检查代码）。
    
  
  

总结

乱码问题的核心是“编码不匹配”：程序输出的编码（如UTF-8）与控制台期望的编码（如GBK）不一致。以上步骤从CLion配置、JVM参数、编译器选项、系统设置等多个层面强制统一为UTF-8，逐步排查后通常能解决问题。如果是旧版本CLion，建议升级到最新版（2023+），对UTF-8的支持更完善。
2.3 第二次尝试成功解决问题后，需探明其中原因

要理解这个问题，我们需要先搞清楚 Windows 控制台的编码机制 与 程序输出编码 的匹配关系。问题的本质是：Windows 控制台默认编码与你的程序输出编码不匹配，而 SetConsoleOutputCP(65001) 是手动强制统一编码的临时解决方案。
1. 为什么需要 SetConsoleOutputCP(65001)？

Windows 系统的控制台（CMD/PowerShell）有一个 “输出代码页”（Code Page）的概念，用于解析程序输出的字节流并显示为文字。默认情况下：
<ul>中文 Windows 的控制台默认代码页是 936（GBK编码），它只能正确解析 GBK 编码的字节流。
C++ 程序（在 CLion 中）默认使用 UTF-8 编码（因为配置了项目编码为 UTF-8），字符串常量（如 std::cout