QFile不能直接读写文本，因readAll()返回QByteArray不解析编码也不处理换行符；必须配合QTextStream并显式设置编码（如UTF-8）才能跨平台安全读写。
QFile 本身不直接处理文本编码和换行符转换，必须配合 QTextStream 才能安全、跨平台地读写文本文件；单独用 QFile::readAll() 或 write() 得到的是原始字节，容易在 Windows/Linux 间出现乱码或换行错乱。
为什么不能只用 QFile::readAll() 读文本？
因为 QFile::readAll() 返回 QByteArray，它不解析编码，也不处理换行符。即使你加了 QIODevice::Text 模式，这个标志只影响底层换行符的自动转换（比如写入时把
变成
），但不会帮你把 UTF-8 字节流转成 QString。结果就是：
- 中文可能显示为
"你好"这样的十六进制乱码 - 用
QString::fromUtf8()强转可能失败——如果文件其实是 GBK 编码 -
QFile::readLine()返回的仍是QByteArray，不是QString，需手动解码
正确读文本：QTextStream + QFile::ReadOnly | Text
用 QTextStream 包裹已打开的 QFile，它会自动按系统默认编码（通常是 UTF-8）解码，并支持显式指定编码：
- 打开前确认文件存在：
file.exists() - 必须用
QIODevice::ReadOnly | QIODevice::Text，否则QTextStream无法启用文本模式换行转换 - 推荐显式设置编码：
stream.setCodec("UTF-8")，避免依赖系统 locale - 逐行读更安全：
while (!stream.atEnd()) { QString line = stream.readLine(); }，比readAll()更省内存
示例关键片段：
QFile file("config.ini");
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
qWarning() << "open failed:" << file.errorString();
return;
}
QTextStream stream(&file);
stream.setCodec("UTF-8");
while (!stream.atEnd()) {
QString line = stream.readLine().trimmed();
// 处理每一行
}
file.close();
正确写文本：QTextStream
写文本几乎总是该用 QTextStream 的 操作符，而不是 <code>QFile::write()。原因：
-
QTextStream自动处理字符串编码（转成字节流）和换行符（Qt::endl对应平台换行） - 覆盖写用
QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text - 追加写用
QIODevice::Append | QIODevice::Text，注意不能和Truncate共存 - 写完建议调用
stream.flush()或file.flush()，确保缓冲区内容落盘（尤其日志场景）
错误示范：file.write("hello
"); —— 这里
不会被转成
，除非你开了 Text 模式且用 QTextStream 写。
常见坑：路径、编码、资源文件混用
这些细节不报错，但会导致读不到内容或写入失败：
- 路径分隔符必须是
/，哪怕在 Windows 上写"C:\data\test.txt"也可能失败，要写成"C:/data/test.txt" - 用
QFile(":/res/config.txt")读资源文件时，只能ReadOnly，不能Truncate或Append（资源是只读的） - 写入中文但没设
setCodec("UTF-8")，Qt 5 默认用系统 locale（Windows 上常是 GBK），Linux 上可能是 UTF-8，跨平台就出问题 - 忘记
file.close()或作用域结束前没释放，可能导致后续同名文件打开失败（尤其 Windows）
最易被忽略的一点：QTextStream 的生命周期必须短于 QFile —— 它只是个包装器，不是独立句柄。先关 file，再让 stream 离开作用域。
