在Qt项目中使用CMake构建时，若需设置UTF-8编码以防止中文乱码或编译错误，可通过以下方式实现：

1. 配置CMake编译选项

在CMakeLists.txt中添加针对MSVC编译器的编码设置：

if (MSVC)
    add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>")
    add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>")
endif()
  • 作用：通过/utf-8参数强制指定MSVC编译器使用UTF-8编码解析源码和执行字符集，解决中文字符串编译报错问题。
  • 注意：此设置仅对MSVC生效，GCC/Clang等编译器默认支持UTF-8，无需额外配置。

2. 统一源码文件编码

  • 文件保存为UTF-8 BOM格式：在Qt Creator中设置默认编码（菜单栏 工具 → 选项 → 文本编辑器 → 行为，选择UTF-8 BOM作为默认编码）。
  • 检查现有文件编码：使用Notepad++等工具将已有文件转换为UTF-8 BOM格式，避免因编码不一致导致MSVC解析错误。

3. 处理字符串转换

在代码中使用QStringLiteral宏包裹中文字符串，避免运行时乱码：

QString str = QStringLiteral("中文内容");
  • 原理：QStringLiteral将字符串编译为UTF-16的Unicode格式，与Qt内部编码一致，无需运行时转换。

4. 设置Qt全局编码（可选）

在main.cpp中添加以下代码，强制使用UTF-8编码：

cpp

复制

#include <QTextCodec>
int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));
    // ...
}
  • 适用场景：需处理外部文件（如文本、配置文件）时，确保读写操作的编码一致性。

5. 验证配置

  • 编译检查：若仍出现乱码，确认源码文件是否包含BOM头（对MSVC必需，其他编译器可能不需要）。
  • 运行时检查：输出中文字符串时，使用qDebug() << QStringLiteral("测试")测试显示是否正常。

总结

以上方法综合解决了CMake构建Qt项目时的UTF-8编码问题，覆盖了编译器配置、文件编码规范和字符串处理三个关键环节。若项目涉及QSS样式表或文件读写，还需注意使用QTextStream处理UTF-8文件

标签: qt, UTF-8, cmake

添加新评论