在C++中逐行读取文件：ifstream与5个致命错误

为什么在C++中简单的文件读取也会让经验丰富的程序员代码出错？

想象一下这个场景：你正在编写一个解析配置文件、日志文件或CSV文件的解析器。一切看起来都很简单——打开文件，逐行读取，处理数据。但在现实中，Stack Overflow上关于"Read file line by line using ifstream in C++"的问题获得了数千次浏览和数百条评论。为什么？因为魔鬼，一如既往，藏在细节中。

在这篇文章中，我们不仅会展示如何正确逐行读取文件。我们还将剖析5个最常见且最危险的错误，这些错误会把可工作的代码变成一堆bug。你将了解到为什么while (!file.eof())是有害的，如何避免丢失最后一行，以及如何处理二进制文件。我们开始吧！

基本语法：如何打开文件并读取一行

我们从基础开始。std::ifstream（输入文件流）类是你读取文件的主要工具。下面是一个最小的工作示例：

#include <iostream>\n#include <fstream>\n#include <string>\n\nint main() {\n    std::ifstream file("example.txt");\n    std::string line;\n\n    if (file.is_open()) {\n        while (std::getline(file, line)) {\n            std::cout << line << std::endl;\n        }\n        file.close();\n    } else {\n        std::cerr << "文件打开失败！" << std::endl;\n    }\n    return 0;\n}

看起来能出什么问题呢？实际上问题不少。

错误 #1：使用 while (!file.eof())

这可能是新手最容易掉入的陷阱。看起来逻辑很合理：“只要没到文件末尾，就继续读取”。但问题在于：

\n
• eof() 只有在读取尝试失败之后才会返回 true。
\n
• 循环会比需要的多执行一次迭代。
\n
• 最后一行会被处理两次，或者你会得到垃圾数据。
\n

灾难示例：

std::ifstream file("data.txt");\nstd::string line;\n\nwhile (!file.eof()) {  // 永远不要这样做！\n    std::getline(file, line);\n    std::cout << line << std::endl;  // 最后一行会被输出两次\n}

正确解决方案： 像第一个示例那样，在循环条件中使用 std::getline。它会返回流本身，该流可以转换为 bool：读取成功时为 true，遇到错误或文件末尾时为 false。

错误 #2：忽略文件打开检查

这看起来显而易见，但GitHub上成千上万行代码正是因此而导致段错误。如果文件不存在或没有读取权限，ifstream 不会抛出异常——它只会处于“损坏”状态。

错误做法：

std::ifstream file("nonexistent.txt");\nstd::string line;\nwhile (std::getline(file, line)) {  // 哎呀！文件没有打开\n    // 这段代码永远不会执行\n}

问题在于你无法得知错误。数据将是空的，程序逻辑也会被破坏。

正确做法：

std::ifstream file("data.txt");\nif (!file) {\n    std::cerr << "无法打开文件！" << std::endl;\n    return 1;\n}\n// 然后进行读取

使用 if (!file) 或 if (!file.is_open())——两者没有区别，都在检查流的状态。

错误 #3：忘记空格和分隔符

运算符 >>（提取运算符）会读取到第一个空格为止。如果你用它代替 std::getline，你可能会得到意想不到的结果。

示例： 文件包含字符串 "Hello World"。

std::string word;\nfile >> word;  // 只会读取 "Hello"\n// word == "Hello"