C++ 标准库提供的 std::getline 函数，是基于分隔符读取文本行的核心工具。与 C 语言中 fgets 依赖固定缓冲区不同，std::getline 直接接收 std::string 对象，长度可动态扩展，有效避免缓冲区溢出风险。
按行读取文本文件几乎出现在所有涉及配置解析、日志分析、数据导入的 C++ 项目中。std::getline 的设计让这项任务变得简洁且安全，但如果不了解它的参数细节与流状态变化，很容易在混合输入、文件结尾判断等环节踩坑。下面从函数原型开始，逐步展开实战应用。
std::getline 函数基础用法
std::getline 不是 istream 的成员函数，而是定义在 <string> 头文件中的全局函数。它有两个常用重载：一个默认以换行符 n 作为分隔符，另一个允许调用者指定任意字符作为分隔符。函数原型分别如下：std::istream& getline(std::istream& is, std::string& str, char delim); 以及 std::istream& getline(std::istream& is, std::string& str);。第一个参数是输入流对象，第二个参数用于存储读取到的字符串，第三个参数是可选的分隔符，默认值为换行符。
读取过程会从流中连续提取字符，直到遇到分隔符、文件末尾或发生流错误。分隔符本身会被读取并丢弃，不会存入目标字符串中。如果流在读取任何字符之前就到达文件末尾，函数会设置流状态中的 eofbit 与 failbit，此时 while 循环条件会判定为 false，从而自然结束遍历。理解这一点对于处理文件最后一行没有换行符的情况非常重要，std::getline 仍然能够正确读出最后一行内容。
#include <iostream>
#include <fstream>
#include <string>
int main() {
std::ifstream file("data.txt");
if (!file.is_open()) {
std::cerr << "无法打开文件" << std::endl;
return 1;
}
std::string line;
while (std::getline(file, line)) {
std::cout << line << std::endl;
}
file.close();
return 0;
}
上面这段代码展示了最基础的按行读取模式。循环条件直接使用 std::getline(file, line)，它返回的是流对象的引用，当流处于有效状态时条件为 true，一旦文件读完或发生错误，条件转为 false。这种写法比先检查 eof 再读取更加安全，可以避免多读一次空行的问题。每次循环中，line 都会被覆盖为文件中的下一行内容，原有内容会被自动清空。
需要注意的是，std::getline 读取的字符串不包含换行符，因此输出时如果需要在控制台保持原有换行格式，要手动添加 std::endl 或 'n'。对于从文件中读取的原始数据，有时候我们想保留换行符以便后续处理，也可以在每个 line 后面追加 'n' 再存储。
实战避坑：混合输入与文件异常处理
一个非常常见的错误发生在同时使用 operator>> 和 std::getline 的场景中。例如先用 std::cin >> age; 读取一个整数，紧接着用 std::getline(std::cin, name); 读取姓名，结果会发现姓名直接读入空字符串。原因在于 operator>> 读取整数时会在输入流中残留一个换行符，而 std::getline 一上来就遇到这个换行符，于是返回一个空行。
解决这个问题的方法是在两种读取方式切换时调用 std::cin.ignore() 清空缓冲区中的残留字符。该函数可以指定要忽略的字符数量，以及遇到哪个字符停止。如果不带参数，默认忽略一个字符。更稳健的写法是 std::cin.ignore(std::numeric_limits<std::streamsize>::max(), 'n');，这样能确保把当前行剩余内容全部清空，不会因为缓冲区中残留多个换行符而再次出现问题。
#include <iostream>
#include <string>
#include <limits>
int main() {
int age;
std::cout << "请输入年龄: ";
std::cin >> age;
std::cin.ignore(std::numeric_limits<std::streamsize>::max(), 'n');
std::string name;
std::cout << "请输入姓名: ";
std::getline(std::cin, name);
std::cout << "年龄: " << age << " 姓名: " << name << std::endl;
return 0;
}
文件读取同样需要处理异常情况。打开文件前应检查 is_open() 返回值，因为路径错误、权限不足、文件被占用都会导致打开失败。如果未检查就调用 std::getline，流已经处于失败状态，循环不会执行任何读取操作，程序可能静默地跳过处理逻辑。对于生产环境，还建议在文件读取结束后检查 file.bad()，以区分是不可恢复的 I/O 错误还是单纯的到达文件末尾。
空行处理也是实战中容易忽略的细节。std::getline 完全可以读取空行，读取后字符串长度为 0，且不会设置 failbit，循环可以继续。如果业务逻辑需要跳过空行，可以在循环体内使用 if (line.empty()) continue;。但这取决于需求，有些场景空行是有意义的分隔符，不可以随意丢弃。
进阶封装：自定义按行读取工具函数
在实际项目中，直接在业务代码里到处写 while 循环读取文件会让代码变得分散且难以维护。更推荐的做法是封装一个通用函数，将文件中的非空行读取到 std::vector<std::string> 中，必要时还能支持过滤注释行、去除首尾空白等功能。下面的示例代码实现了一个简单的按行读取工具，自动跳过空行和以井号开头的注释行，非常适合读取配置文件。
#include <iostream>
#include <fstream>
#include <string>
#include <vector>
std::vector<std::string> readLines(const std::string& filename) {
std::vector<std::string> lines;
std::ifstream file(filename);
if (!file.is_open()) {
return lines;
}
std::string line;
while (std::getline(file, line)) {
if (line.empty() || line[0] == '#') {
continue;
}
lines.push_back(line);
}
return lines;
}
int main() {
std::vector<std::string> config = readLines("config.txt");
for (const auto& item : config) {
std::cout << item << std::endl;
}
return 0;
}
std::getline 还支持自定义分隔符，这使它不仅能按行读取，还能直接解析 CSV 或类似格式的数据。例如传入逗号 ',' 作为分隔符，就可以按字段拆分一行记录。不过在处理复杂 CSV 时，字段内部可能包含引号与逗号，单纯依赖 getline 会有局限性，此时通常需要编写状态机或使用第三方库。对于简单场景，自定义分隔符足够高效。
另一个值得注意的细节是换行符的跨平台差异。Windows 使用回车换行符 rn，Linux 与 macOS 使用 n。如果以文本模式打开文件，C++ 标准库会自动将 Windows 的 rn 转换为 n，因此 std::getline 读到的字符串末尾不会包含 r。但如果以二进制模式打开，每个 r 都会保留在字符串中，处理时需要额外清理。
封装后的按行读取函数可以继续扩展，比如增加对文件编码的检测、限制单行最大长度以防止恶意文件导致内存膨胀、统计行数等。无论需求如何变化，std::getline 作为底层读取工具，都能提供稳定且高效的基础支持。掌握它的流状态语义和与 operator>> 混用时的注意事项之后，处理文本文件会变得相当得心应手。