应统一源文件、IDE默认、编译器及控制台编码为UTF-8无BOM：1. 源文件保存为UTF-8无BOM；2. Qt Creator设默认编码为UTF-8且禁用BOM；3. .pro中添加-finput-charset=UTF-8等参数；4. Windows下main()调用SetConsoleOutputCP(CP_UTF8)；5. 字符串用QString::fromUtf8()或u8前缀。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake开发工具时遇到中文显示为方块、问号或“烫烫烫”等异常字符，则很可能是源文件编码、编译器解读编码与运行时终端解码编码三者之间发生错配。以下是解决此问题的步骤：
一、统一源代码文件编码为UTF-8无BOM
确保所有.cpp、.h、.ui等源文件均以UTF-8无BOM格式保存，这是跨平台编码一致性的基础。BOM在Windows下可能被MSVC识别，但在Linux/macOS中易引发解析错误，故应主动禁用。
1、在Qt Creator中打开目标文件。
2、点击右下角当前编码标识（如“GBK”或“System”）。
3、选择UTF-8 without BOM，并勾选“另存为”确认覆盖。
4、对项目中全部含中文的源文件重复执行上述操作。
二、配置Qt Creator全局默认编码
避免新建文件继承错误编码，需将IDE默认行为锁定为UTF-8无BOM，防止后续文件再次引入编码偏差。
1、进入工具 → 选项 → 文本编辑器 → 行为。
2、将“默认编码”下拉菜单设置为UTF-8。
3、取消勾选“如果编码是UTF-8则添加BOM”选项。
4、点击“确定”并重启Qt Creator使设置生效。
三、修改.pro工程文件强制编译器使用UTF-8
通过qmake指令显式声明输入与执行字符集，使GCC/MinGW和MSVC均按UTF-8解析字符串字面量，切断系统默认编码干扰链。
1、在项目根目录的.pro文件末尾添加以下内容：
QMAKE_CXXFLAGS += -finput-charset=UTF-8 -fexec-charset=UTF-8
2、若使用MSVC编译器，在.pro中追加条件块：
win32-msvc {
QMAKE_CXXFLAGS += /utf-8
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
QMAKE_CFLAGS += /utf-8
}
3、保存.pro文件后，点击构建 → 执行qmake刷新项目配置。
四、运行时控制台输出编码适配
即使源码与编译正确，Windows控制台仍默认以GBK解码输出流，导致qDebug或printf的UTF-8字节被误读。需在程序启动时主动同步控制台编码。
1、在main()函数开头插入以下代码（仅Windows有效）：
#ifdef Q_OS_WIN
SetConsoleOutputCP(CP_UTF8);
SetConsoleCP(CP_UTF8);
#endif
2、确保包含头文件：#include <windows.h>（Windows平台）。
3、重新构建并运行程序，验证控制台输出是否正常显示中文。
五、字符串字面量显式声明UTF-8语义
绕过编译器隐式编码推断，直接告知Qt该字符串按UTF-8解释，适用于所有平台且不依赖环境变量或系统区域设置。
1、将原始字符串写法 "中文内容" 替换为：
QString::fromUtf8("中文内容")
2、或使用C++11 UTF-8字面量前缀（Qt 5.7+支持）：
QStringLiteral(u8"中文内容")
3、对于界面文本，优先采用tr()机制配合lupdate工具生成翻译文件，避免硬编码。
