讲师中心 微信公众号
AI工具推荐 视频效率加速

Qt Creator中文乱码报错怎么处理?

冬伟大大_7937

冬伟大大_7937

发布时间:2026-08-09 20:33:48

|

617人浏览过

|

来源于php中文网

原创

Qt Creator中文乱码或编译报错主因是源文件编码与MSVC解读不匹配:须保存为UTF-8 with BOM,并在.pro或CMakeLists.txt中添加/utf-8;字符串推荐u8"你好"或QStringLiteral(u8"你好");控制台输出需chcp 65001或SetConsoleOutputCP(CP_UTF8);.qrc内文本也须转UTF-8-BOM。

qt creator中文乱码报错怎么处理?

Qt Creator里中文乱码或编译报错,90%是源文件编码和MSVC编译器解读方式不匹配——不是代码写错了,而是编译器根本没“看懂”你写的中文。

源文件必须保存为UTF-8 with BOM

MSVC(尤其是老版本)不认纯UTF-8,它靠BOM(EF BB BF)判断文件是不是UTF-8。没BOM就默认按GBK读,一读就错,轻则显示方块,重则编译报error C2001: 常量中有换行符error C2065: 未声明的标识符(其实是把中文当成了非法字符)。

  • Qt Creator中:菜单栏 工具 → 选项 → 文本编辑器 → 行为,把默认编码设为UTF-8,并勾选添加 UTF-8 BOM
  • 已有文件乱码:用Notepad++打开,编码 → 转为UTF-8-BOM,再保存
  • 新建文件会自动带BOM,但复制粘贴进来的中文可能不继承编码,建议手动检查

编译器参数要显式指定UTF-8输入

光靠BOM还不够,特别是Qt 5.15+或Qt 6项目,MSVC需要明确指令告诉它“源码是UTF-8”。否则即使文件带BOM,某些构建配置下仍会回退到系统代码页。

Qt Creator 18.0.2
Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载
  • .pro文件里加这行:QMAKE_CXXFLAGS += /utf-8(MSVC专用)
  • 如果是CMake项目,在CMakeLists.txt中加:set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /utf-8")
  • MinGW用户不用加这个,但要确保QMAKE_CXXFLAGS += -finput-charset=UTF-8

字符串字面量别裸写中文

直接写QString str = "你好";依赖源文件编码,风险高。换成更健壮的写法,让编译器和Qt都明确知道这是UTF-8。

  • Qt 5.10+推荐:QString str = QStringLiteral(u8"你好"); —— u8强制UTF-8字节流,QStringLiteral编译期转成UTF-16,零运行时开销
  • Qt 6+可简化为:QString str = u8"你好";(C++17标准支持)
  • 绝对避免:QString::fromLocal8Bit("你好")——Windows下会按GBK解,结果是乱码

控制台输出中文还是乱?那是终端的事

程序本身没乱码,但qDebug()std::cout打到Windows控制台时又变方块,这不是Qt问题,是cmd/powershell默认用GBK,而你的程序输出的是UTF-8。

  • 临时解决:运行前在cmd里执行chcp 65001(切换UTF-8代码页)
  • 工程级方案:在main()开头加SetConsoleOutputCP(CP_UTF8);(Windows API),需#include <windows.h></windows.h>
  • 注意:qDebug()输出走Qt自己的日志系统,不受控制台代码页影响;但printfstd::cout会受限制

最常被忽略的一点:.qrc资源文件里嵌的HTML/JSON/文本,如果本身是GBK保存的,加载进来就是错的——BOM和编译器参数对它无效,必须单独转成UTF-8-BOM再加入资源。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
视频后缀名都有哪些
视频后缀名都有哪些

视频后缀名都有avi、mpg、mpeg、rm、rmvb、flv、wmv、mov、mkv、ASF、M1V、M2V、MPE、QT、VOB、RA、RMJ、RMS、RAM、等等。更多关于视频后缀名的相关知识,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

9505

2023.10.31

C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

3562

2025.08.15

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

1341

2025.12.05

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

20

2026.09.21

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

0

2026.09.21

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

0

2026.09.21

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

0

2026.09.21

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

0

2026.09.21

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

40

2026.09.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Qt入门课堂 - Qt Quick Controls
Qt入门课堂 - Qt Quick Controls

共0课时 | 0人学习

Qt Creator 调试文档
Qt Creator 调试文档

共0课时 | 0人学习

Qt Creator 项目创建文档
Qt Creator 项目创建文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn