前言

printf("你好\n")在 VS 里输出一堆"锟斤拷" —— 这几乎是每个中文 Windows 下的 C/C++ 初学者都会撞上的坑。

网上的解决方案五花八门：改文件编码、加chcp 65001、勾选某个选项……但大多数文章只给了操作步骤，没说清为什么。结果换个场景又乱码了。

本文把乱码的完整链路拆开讲，看完你应该能自己判断任何情况下该怎么配。

一、先搞清楚乱码发生的三个环节

中文字符从"你写在源码里"到"显示在屏幕上"，要经过三次编码转换：

①源文件编码 ②执行字符集 ③控制台代码页 ┌──────────┐ 编译器 ┌──────────┐ 运行时 ┌──────────┐ │ .cpp 文件 │ ───────> │ .exe 里 │ ───────> │ 控制台按 │ │ 存的字节 │ 解析 │ 的字节 │ 写出 │ 某编码显示│ └──────────┘ └──────────┘ └──────────┘ UTF-8? UTF-8? UTF-8? GBK? GBK? GBK(936)?

关键结论：三个环节的编码必须"对得上"，任何一处不一致，就会乱码。

乱码的本质不是"显示错了"，而是字节在被解读时用了错误的编码表。

二、复现问题

新建一个控制台项目，写：

#include <cstdio> int main() { printf("你好，世界\n"); return 0; }

在中文 Windows + VS 默认配置下，输出大概率是乱码（比如浣犲ソ或锟斤拷）。

为什么会这样？往下看。

三、三个环节的默认值

3.1 环节①：源文件编码

VS 保存文件时，默认不加 BOM，并使用系统 ANSI 代码页。

在中文 Windows 上，系统 ANSI 代码页是936（GBK）。

但如果你是用 VS Code 或别的编辑器创建的文件，很可能是UTF-8 无 BOM。

3.2 环节①→②：MSVC 怎么解析源文件

这是问题最隐蔽的一环。

MSVC 判断源文件编码的规则：

所以：一个 UTF-8 无 BOM 的文件，如果里面写了中文，MSVC 会拿 GBK 去解码 UTF-8 字节 → 编译期就已经乱掉了。

这种情况下面无论怎么改控制台编码都没用，因为源头上就错了。

3.3 环节②：执行字符集

编译器解析完源码后，要把字符串字面量写进.exe。用什么编码写？由执行字符集决定。

MSVC 默认：执行字符集 = 系统 ANSI（GBK）。

3.4 环节③：控制台代码页

中文 Windows 的cmd.exe默认代码页是936（GBK）。

可以自己验证：

chcp :: 输出：活动代码页: 936

四、默认配置下到底错在哪

假设你写了个UTF-8 无 BOM的源文件：

你的源码字节（UTF-8）："你好" → E4 BD A0 E5 A5 BD ↓ MSVC 用 GBK 解码，但以为是合法的 编译后 exe 里的字节： ??? ↓ 控制台按 GBK 显示 屏幕： 乱码

这一步就已经错了，且无法在运行期挽回。

如果源文件存的是GBK，那链路是自洽的：

源码字节（GBK）："你好" → C4 E3 BA C3 ↓ MSVC 按 GBK 解码 ✓ exe 里的字节：C4 E3 BA C3（GBK） ↓ 控制台 CP936 显示 ✓ 屏幕：你好 ✓ 正确

所以最原始的解决方案就是：把源文件存成 GBK。

但这在现代开发里是个坏主意（跨平台、Git、CI 都偏好 UTF-8）。正确的做法是让整条链路统一到 UTF-8。

五、解决方案（按推荐度排序）

方案一：/utf-8编译选项 ★ 最推荐

这是一步到位的方案，一次解决环节①和②：

操作步骤：

1. 
   
2. 项目 → 属性 →C/C++ → 命令行
3. 
   
4. 在「其他选项」里填入/utf-8
5. 
   
6. 确定，重新生成
7. 
   
   

或者直接在.vcxproj里加：

<ClCompile> <AdditionalOptions>/utf-8 %(AdditionalOptions)</AdditionalOptions> </ClCompile>

/utf-8等价于什么？

/utf-8 ≡ /source-charset:utf-8 /execution-charset:utf-8

即：源文件按 UTF-8 解析，字符串字面量也按 UTF-8 写入 exe。

⚠️但还差最后一步—— 控制台（环节③）仍是 CP936，需要配套设置。

方案二：设置控制台输出代码页

在main开头加：

#include <windows.h> #include <cstdio> int main() { // 把控制台输出代码页切到 UTF-8 SetConsoleOutputCP(CP_UTF8); printf("你好，世界\n"); return 0; }

如果还需要读取中文输入，再加一行：

SetConsoleCP(CP_UTF8); // 输入代码页

方案一 + 方案二 = 完整解法：

#include <windows.h> #include <cstdio> int main() { SetConsoleOutputCP(CP_UTF8); printf("你好，世界\n"); return 0; }

编译选项加/utf-8，源文件存UTF-8 无 BOM，即可正确输出。

方案三：源文件存成 GBK（最省事，但不推荐）

不写任何编译选项、不动控制台代码页，只把源文件另存为 GBK：

• 
  
• 文件 → 另存为 → 编码选「简体中文 (GB2312) - 代码页 936」
• 
  
  

这样链路自洽，立即就不乱码了。

缺点：

• 
  
• 代码分享给别人、提交到 Git、在 CI 上编译时，别人未必是中文 Windows
• 
  
• 换到 Linux/macOS 编译必然乱码
• 
  
• 现代编辑器（VS Code）默认 UTF-8，来回切换很烦
• 
  
  

只适合本机临时验证代码。

方案四：加 UTF-8 BOM

把源文件存为「UTF-8 带有签名」（即带 BOM）：

• 
  
• 文件 → 另存为 → 编码选「UTF-8 带有签名」
• 
  
  

原理：BOM 让 MSVC 知道这是 UTF-8 源文件（解决环节①），但执行字符集仍然是 GBK（环节②），于是字符串被转成 GBK 存进 exe，而控制台默认 CP936 ——恰好对上了。

优缺点：

• 
  
• ✅ 不用改编译选项，不用改代码
• 
  
• ❌ 只在中文 Windows 上碰巧成立；换日文/英文系统就崩
• 
  
• ❌ BOM 会给某些工具链带来麻烦（GCC 早期版本、部分构建脚本）
• 
  
  

方案五：#pragma execution_character_set（已废弃）

#pragma execution_character_set("utf-8") // ❌ 不要再用了

为什么废弃：这个 pragma 只影响字面量的执行字符集，不影响源文件解析编码。如果你的源文件是无 BOM 的 UTF-8，MSVC 还是按 GBK 解析，问题依旧。

VS2015 起官方推荐用/utf-8替代。

六、组合对照表

这张表能直接查你当前是哪种情况：

记忆方法："执行字符集"和"控制台代码页"必须一致。再保证源文件能被 MSVC 正确识别（有 BOM 或加/utf-8）。

七、进阶：几个容易忽略的细节

7.1 Windows Terminal 与 conhost 表现不同

• 
  
• 传统 conhost（cmd.exe窗口）：代码页跟随系统，默认 936。
• 
  
• Windows Terminal：默认使用 UTF-8。
• 
  
  

所以同一份 exe，在 cmd 里乱码、在 Windows Terminal 里正常—— 这不是你的程序有问题，是宿主的代码页不同。用chcp可以验证。

7.2std::cout与wprintf的坑

std::wcout << L"你好" << std::endl; // ❌ 可能什么都不输出

宽字符输出需要先设置 locale：

#include <clocale> #include <iostream> int main() { std::setlocale(LC_ALL, ""); // 或 setlocale(LC_ALL, "zh_CN.UTF-8") std::wcout << L"你好" << std::endl; return 0; }

注意：wcout和cout混用会导致输出顺序错乱（两者缓冲区独立），尽量避免。

7.3SetConsoleOutputCP会影响整个控制台

它修改的是控制台窗口的状态，而不仅仅是本程序。程序退出后如果没恢复，宿主的代码页就被改掉了。

规范做法：

UINT oldCP = GetConsoleOutputCP(); SetConsoleOutputCP(CP_UTF8); // ... 你的代码 ... SetConsoleOutputCP(oldCP); // 恢复

在 Debug 模式下用Ctrl+F5运行时，窗口是本程序创建的，退出即销毁，所以不恢复也无所谓。但如果是被别的程序调用的控制台子进程，就必须恢复。

7.4 文件读写同样受影响

同样的编码问题会出现在读写文本文件时：

FILE* f = fopen("data.txt", "w"); fprintf(f, "中文内容\n"); // 写入的字节编码 = 执行字符集 fclose(f);

如果执行字符集是 GBK，用 UTF-8 编辑器打开这个文件就会乱码。

跨平台代码建议：明确用二进制模式写入 UTF-8 字节，不要依赖执行字符集。

7.5/utf-8只影响本项目的编译

如果你引用了第三方库的头文件（那些头文件可能是 GBK 的），加/utf-8后它们会解析错误。

解法：用/source-charset单独指定，或者给第三方库单独设置。

八、最终推荐配置

新项目、纯 UTF-8 环境：

1. 源文件保存为：UTF-8 无 BOM 2. 项目属性 → C/C++ → 命令行 → 其他选项：/utf-8 3. main 函数开头：SetConsoleOutputCP(CP_UTF8);

完整示例：

#include <windows.h> #include <cstdio> int main() { SetConsoleOutputCP(CP_UTF8); printf("你好，世界\n"); printf("中文测试：一二三四五\n"); return 0; }

旧项目、不想改编译选项：

源文件保存为 GBK，其余不动。

跨平台项目：

源文件 UTF-8 无 BOM GCC/Clang 默认就是 UTF-8，无需额外选项 Windows 端单独加 /utf-8 + SetConsoleOutputCP

九、总结

1. 
   
2. 乱码的本质是三次编码转换中某一环不匹配：源文件编码 → 执行字符集 → 控制台代码页。
3. 
   
4. 最隐蔽的坑是"UTF-8 无 BOM"：MSVC 会按 GBK 解析，编译期就错了，运行期怎么改都没用。
5. 
   
6. /utf-8一次性解决前两个环节，是最推荐的方案。
7. 
   
8. 控制台代码页必须与执行字符集一致，UTF-8 执行字符集要配SetConsoleOutputCP(CP_UTF8)。
9. 
   
10. "存成 GBK 就好了"能解决问题但不能跨平台，只适合临时验证。
11. 
    
12. #pragma execution_character_set已废弃，别再用了。
13. 
    
    

排查顺序记住一句话：先确认源文件有没有 BOM，再看编译选项，最后看控制台chcp。三步走完，没有解决不了的乱码。

本文基于 Visual Studio 2022 + 中文 Windows 10/11 实测。不同 VS 版本界面位置可能略有差异。如果帮到你，欢迎点赞收藏。