应将源文件转为utf-8无bom编码,因编译器默认按utf-8解析,而windows记事本等常保存为gbk或utf-8带bom,导致invalid multibyte character等错误。

读取含中文注释的 C++ 源文件时编译报错:不是 UTF-8 编码
常见现象是 g++ 或 clang++ 报类似 invalid multibyte character 或 source file is not valid UTF-8 的错误,尤其在 Windows 下用记事本保存、或 VS Code 默认用 GBK 保存时高频出现。
根本原因不是 C++ 不支持中文,而是编译器(尤其是 GCC)默认按 UTF-8 解析源文件,而你文件实际是 GBK/GB2312/UTF-8 with BOM 等编码。C++ 标准只要求源文件是“可表示为基本源字符集的序列”,但实现上编译器会按自己认定的编码去解码字节流。
- Linux/macOS 终端环境通常默认 UTF-8,但编辑器仍可能另存为其他编码
- Windows 上记事本默认保存为
GBK(ANSI),VS Code 默认是 UTF-8,但若手动改过保存编码就容易不一致 -
g++从 9.0+ 开始支持-finput-charset=,但老版本(如 Ubuntu 18.04 自带的 7.5)不支持,必须靠外部转换
用 iconv 或 Notepad++ 手动转成 UTF-8(无 BOM)最稳妥
别依赖 IDE 自动识别——很多编辑器声称“自动检测编码”,实际只是猜,一猜就错。直接转码才是可控路径。
- Linux/macOS 终端执行:
iconv -f GBK -t UTF-8 input.cpp -o output.cpp(把GBK换成你文件真实编码,可用file -i input.cpp查) - Windows 上用 Notepad++:菜单栏「编码 → 转为 UTF-8 无 BOM 编码 → 保存」,千万别选「UTF-8」(它带 BOM),要选「UTF-8 无 BOM」
- VS Code 用户:右下角点击编码名称(如
GBK),选「Save with Encoding → UTF-8」;注意不要点「Reopen with Encoding」,那是只临时查看,不改文件内容
gcc/clang 编译时指定输入编码(仅限较新版本)
如果你确定不能改源文件(比如是别人给的遗留代码),且编译器够新,可以用参数绕过,但有兼容性风险。
-
g++ -finput-charset=GBK source.cpp—— GCC 9.1+ 支持,旧版直接报错 unrecognized option -
clang++ --input-charset=GBK source.cpp—— Clang 10+ 支持,行为与 GCC 类似 - 注意:
-finput-charset只影响源文件解析,不影响char字面量或运行时字符串编码 - 不建议在 CI 或跨团队项目中依赖该参数,因为构建环境编译器版本不可控
locale 设置对编译器没用,别白费劲
有人试过改 LANG=zh_CN.GBK 或 export LC_ALL=zh_CN.UTF-8,发现完全不影响 g++ 报错——这是对的。GCC/Clang 解析源码时不查系统 locale,只认文件字节流和显式传入的 -finput-charset。
唯一例外是某些老版本 MinGW 在 Windows 上可能受控制台代码页影响,但那属于极端边缘情况,优先转文件编码更可靠。
真正容易被忽略的是:BOM。UTF-8 文件带 BOM(即开头三个字节 EF BB BF)会被 GCC 当作非法字符处理,报 invalid preprocessing directive 或类似错误。所以“转 UTF-8”必须是“UTF-8 无 BOM”。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











