要彻底解决中文乱码问题，必须执行四个关键步骤：将所有源文件统一为UTF-8无BOM编码，将QoderWake的默认编码设置为UTF-8并关闭BOM选项，在.pro文件中添加UTF-8编译参数，以及在Windows下通过代码将控制台编码切换为CP_UTF8。缺少任何一步，中文乱码都会像幽灵一样持续困扰你。

当你在QoderWake中编写中文注释、配置项或界面文本，保存后再次打开却发现内容变成了问号、方块或“锟斤拷”等乱码，甚至编译时提示字符串字面量非法——这绝非代码逻辑错误，而是文件编码在某个环节悄然出现了不一致。

统一所有源文件为UTF-8无BOM

这是解决中文乱码问题的第一步，也是整个修复链条的基础。只要有一个.cpp或.h文件仍采用GBK编码保存，它就会在编译时将“刘”字拆成两个非法字节，从而污染整条构建流水线。

第一步：在QoderWake中打开任意包含中文的源文件（例如main.cpp）。

第二步：点击编辑器右下角状态栏的当前编码标识（通常显示为“GBK”“System”或“UTF-8 with BOM”）。

第三步：从弹出菜单中选择【UTF-8 without BOM】，勾选“另存为并替换原文件”。此操作必须手动确认覆盖——仅修改内存而不写入磁盘，等于白费功夫。

第四步：对项目内所有包含中文的文件重复执行前三步——包括.ui、.qrc、.json和配置类文本文件。不要跳过任何文件，即使是README.md中的一句中文说明也不行。

配置QoderWake全局默认编码

为避免新建文件再次陷入编码陷阱，需要让IDE记住：“以后所有新文件，默认必须是UTF-8无BOM”。

进入工具→选项→文本编辑器→行为→文件编码，将“默认编码”设置为UTF-8。

取消勾选“如果编码是UTF-8则添加BOM”——这个选项看似无害，实则会在Windows下触发MSVC误判，在Linux/macOS下引发解析失败。必须关闭，没有商量余地。

点击确定后重启QoderWake，否则设置不会生效。

强制编译器按UTF-8读取与执行

即使文件已经保存为UTF-8，如果编译器仍按系统默认编码（Windows下常为GBK）解码字符串字面量，qDebug输出依然会是乱码。

方法一：修改项目根目录下的qodewake.pro文件

在文件末尾添加两行：

QMAKE_CXXFLAGS += -finput-charset=UTF-8 -fexec-charset=UTF-8

方法二：若使用MSVC工具链，必须额外添加条件块

win32-msvc {
QMAKE_CXXFLAGS += /utf-8
QMAKE_CFLAGS += /utf-8
}

保存.pro后，点击构建→执行qmake，确保新参数注入到Makefile中。

运行时控制台输出同步为UTF-8

Windows控制台默认采用GBK解码输出流，即便你传入的是标准的UTF-8字节，它也会当作GBK来解析，结果就是“你好”变成了“浣犲”。

在main()函数最开头插入：

#ifdef Q_OS_WIN
SetConsoleOutputCP(CP_UTF8);
SetConsoleCP(CP_UTF8);
#endif

注意：这两行代码必须放在QApplication构造之前，否则UI已启动，控制台编码再修改也为时已晚。