3、文本文件读取（下）：处理读取异常
上一节我们把文本文件读出来了，看起来挺顺利对吧？
但说实话，真实项目里哪有这么顺的。我刚开始做Qt开发那会儿，就吃过这个亏——程序写好了，演示给客户看，结果一点"打开文件"，程序直接崩了。原因？文件不存在。
所以这一节，咱们就来聊聊怎么优雅地处理这些读取异常。说白了，就是让程序在出错时不崩溃，还能告诉用户到底出了什么问题。
3.1 常见的文件读取异常
在实际开发中，文件读取可能遇到的情况比你想的要多。我列几个最常见的：
- 文件不存在——用户选了个已经被删除的文件
- 权限不足——文件是只读的，或者被其他进程锁住了
- 文件被占用——比如Excel文件正被另一个程序打开
- 路径错误——路径里有非法字符
- 磁盘错误——U盘突然拔掉了
你想想看，如果这些情况都不处理，用户看到的就是一个莫名其妙的崩溃窗口。嗯，那体验可就太糟糕了。
3.2 用QFile::exists()提前检查
最简单的办法，就是在打开文件之前先检查一下文件是否存在。Qt提供了QFile::exists()这个静态方法，用起来很方便。
QString filePath = QFileDialog::getOpenFileName(this, "选择文件");
if (filePath.isEmpty()) {
return; // 用户取消了选择
}
// 检查文件是否存在
if (!QFile::exists(filePath)) {
QMessageBox::warning(this, "错误", "文件不存在！");
return;
}
QFile file(filePath);
// 继续读取操作...我个人习惯把这种检查放在最前面。为什么呢？因为一旦文件不存在，后面的所有操作都是白费功夫，早点返回还能省点资源。
3.3 用QFile::open()捕获权限问题
文件存在不代表就能打开。权限不足这个问题，我在项目中遇到过好几次。比如在Linux系统下，有些配置文件只有root才能读，普通用户一打开就报错。
QFile::open()方法会返回一个bool值，告诉我们是否成功打开了文件。我们可以利用这个返回值来做判断：
QFile file(filePath);
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
// 打开失败，获取错误信息
QString errorMsg;
switch (file.error()) {
case QFile::OpenError:
errorMsg = "文件无法打开，可能被其他程序占用。";
break;
case QFile::PermissionsError:
errorMsg = "权限不足，无法读取该文件。";
break;
case QFile::ResourceError:
errorMsg = "磁盘错误，可能存储设备已断开。";
break;
default:
errorMsg = "未知错误：" + file.errorString();
break;
}
QMessageBox::critical(this, "读取失败", errorMsg);
return;
}
// 文件打开成功，继续读取
QTextStream in(&file);
QString content = in.readAll();
file.close();关键点： file.error()返回的是QFile::FileError枚举值，不同的错误类型对应不同的提示信息。这样用户就能知道具体是什么问题，而不是看到一个笼统的"打开失败"。
3.4 用QMessageBox展示错误信息
Qt提供了几种消息框，适合不同的场景：
| 消息框类型 | 适用场景 | 图标 |
|---|---|---|
| QMessageBox::information() | 普通提示信息 | 蓝色 i 图标 |
| QMessageBox::warning() | 警告，但程序可以继续运行 | 黄色三角图标 |
| QMessageBox::critical() | 严重错误，程序可能无法继续 | 红色叉号图标 |
| QMessageBox::question() | 询问用户是否继续操作 | 蓝色问号图标 |
对于文件读取异常，我个人建议：
- 文件不存在 → 用
warning，因为用户可以换个文件再试 - 权限不足 → 用
critical，因为这个问题用户自己可能解决不了 - 其他错误 → 用
critical，并显示具体的错误信息
小技巧： 你可以在QMessageBox里加上"详细信息"按钮，把file.errorString()的完整内容放进去。这样普通用户看到的是简洁的提示，开发人员又能看到详细的错误日志。
3.5 完整的异常处理代码
好了，我们把上面的内容整合一下，写一个完整的文件读取函数：
void MainWindow::onOpenFile() {
QString filePath = QFileDialog::getOpenFileName(
this,
"打开文本文件",
QString(),
"文本文件 (*.txt);;所有文件 (*)"
);
if (filePath.isEmpty()) {
return; // 用户取消了
}
// 第一步：检查文件是否存在
if (!QFile::exists(filePath)) {
QMessageBox::warning(this, "文件不存在",
"找不到指定的文件，请检查路径是否正确。");
return;
}
// 第二步：尝试打开文件
QFile file(filePath);
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
QString errorMsg;
switch (file.error()) {
case QFile::PermissionsError:
errorMsg = "没有读取该文件的权限。\n"
"请尝试以管理员身份运行程序。";
break;
case QFile::OpenError:
errorMsg = "文件被其他程序占用，请关闭后再试。";
break;
default:
errorMsg = "打开文件时出错：" + file.errorString();
break;
}
QMessageBox::critical(this, "读取失败", errorMsg);
return;
}
// 第三步：读取内容
QTextStream in(&file);
QString content = in.readAll();
file.close();
// 第四步：显示内容
ui->textEdit->setPlainText(content);
// 更新状态栏
statusBar()->showMessage("已打开：" + filePath, 3000);
}注意： 我曾经犯过一个错误——在QMessageBox::critical之后忘记return，结果程序继续往下执行，读取了一个没打开的文件，又报了一堆错。所以记得，一旦检测到错误，就要立即返回，不要再往下走了。
3.6 知识体系流程图
下面这张图，把文件读取异常处理的整个流程串起来了：
这个流程其实很简单：先检查存在性，再检查可读性，最后才读取内容。每一步都有对应的错误处理，用户看到的是友好的中文提示，而不是一堆看不懂的异常堆栈。
3.7 避坑指南
最后，分享几个我踩过的坑：
- 不要用try-catch捕获文件异常——Qt的文件操作不会抛出C++异常，用try-catch是抓不到的。老老实实用返回值判断吧。
- 文件路径中的中文问题——在Windows下，如果路径包含中文，
QFile::exists()可能返回false。解决办法是用QDir::toNativeSeparators()转换一下路径格式。 - 大文件读取超时——如果文件特别大（比如几百MB），
readAll()可能会卡住界面。这种情况建议用readLine()逐行读取，或者配合QProgressDialog显示进度。
嗯，文件读取的异常处理就讲到这里。记住一句话：永远不要相信用户输入的文件路径。多一层检查，少一次崩溃。