qfile读文件为空的根本原因是未调用open()或打开模式错误；必须显式open并指定qiodevice::readonly | qiodevice::text，注意路径处理与编码设置。
QFile 读文件时为什么总是空？
根本原因通常是没调用 open() 或打开模式不对。QFile 不像 C++ std::ifstream 那样构造即打开，它必须显式调用 open() 并传入正确标志。
- 读文本文件务必用
QIODevice::ReadOnly | QIODevice::Text，漏掉QIODevice::Text可能导致换行符处理异常（尤其 Windows 下的\r\n） - 路径错误不会立即报错，
open()返回false，但很多人忽略这个返回值 - 中文路径在 Windows 上容易失败——不是编码问题，而是 Qt 默认用系统本地编码解析路径，建议统一用
QDir::toNativeSeparators()处理路径分隔符，并确保项目编码为 UTF-8（.pro 文件加CODECFORSRC = UTF-8）
示例：
QFile file("config.json");
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
qWarning() <h3>QFile 写文件时内容没保存或乱码</h3><p>核心陷阱是：没指定 <code>QIODevice::Text</code> 模式、没调用 <code>flush()</code>、或没检查 <code>write()</code> 返回值。</p>
- 写文本时必须带
QIODevice::Text，否则write("abc\n")在 Windows 下不会自动转成\r\n -
write()返回实际写入字节数，小于预期说明出错了（比如磁盘满、权限不足），但很多人直接忽略返回值 - 用
QTextStream包裹QFile写字符串更安全，它会自动处理编码（默认 UTF-8），但要记得设setAutoDetectUnicode(false)避免误判
推荐写法：
QFile file("log.txt");
if (!file.open(QIODevice::WriteOnly | QIODevice::Append | QIODevice::Text)) return;
<p>QTextStream out(&file);
out.setCodec("UTF-8"); // 显式声明，不依赖 auto-detect
out </p>
QFile 和 QFileDevice 的区别在哪？
你几乎不需要直接用 QFileDevice。它是 QFile、QTemporaryFile、QProcess 等的抽象基类，只提供底层读写接口（如 readData()、writeData()）。日常开发中所有文件操作都走 QFile 就够了。
-
QFile是唯一带文件名管理的类：支持fileName()、exists()、remove()、copy()等便捷方法 -
QFileDevice没有文件名概念，不能直接构造，只能被继承；Qt 文档里提到它，主要是为了说明“为什么QProcess也能用read()” - 如果你看到别人重写
QFileDevice::readData()，那是在实现自定义设备（比如内存映射文件封装），不是普通文件 IO 场景
QFile 在多线程里能不能共用？
不能。QFile 不是线程安全的，同一 QFile 实例不能跨线程调用 read()、write() 或 close()。
- 常见错误：主线程创建
QFile，然后传给子线程去读——崩溃或数据错乱大概率发生 - 正确做法：每个线程自己 new 一个
QFile，用相同路径打开（操作系统层面允许多个句柄同时读同一文件） - 如果需要线程间共享数据，用
QByteArray或信号槽传递内容，而不是共享QFile对象 - 注意：
QFile::exists()这类只读元信息操作虽通常不崩溃，但仍不保证原子性，高并发下可能返回过期结果
文件 IO 看似简单，但 QFile 的状态机（open/close/pos/error）和平台路径差异，让很多 bug 出现在边界条件里——比如文件正被其他程序占用时的 open() 返回值、临时断电导致 write() 只写了一半、或者 Linux 下大小写敏感路径误判。别信“应该没问题”，每次 open() 后查 isOpen()，每次 write() 后核对返回值，比事后 debug 快得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
