断点续传需手动记录并恢复文件读取位置：用二进制模式打开文件，以std::streamoff保存tellg()获取的偏移量，转为字符串存入.offset文件，再用stoll()安全读回。
断点续传的核心是保存和恢复 std::ifstream 的读取位置
关键不在“传”，而在“记”——C++ 本身不提供自动断点续传机制，必须手动记录上次读到的字节偏移，并在下次打开文件时用 seekg() 跳转。常见错误是直接用 tellg() 获取位置却忽略其返回值可能为 -1（失败），或在文本模式下读取后位置不可靠。
- 务必用二进制模式打开文件：
std::ifstream file("data.bin", std::ios::binary)，否则tellg()/seekg()在 Windows 换行符处理下会失准 -
tellg()必须在有效读操作后调用，且需检查返回值：if (file.tellg() == -1) { /* 错误处理 */ } - 偏移量必须存为
std::streamoff类型（而非int或size_t），它能跨平台表示大文件位置
如何安全保存和加载断点位置（std::streamoff）
不能直接把 std::streamoff 当整数写进文本文件——不同平台该类型可能是 long long 或 long，且符号位敏感。最稳妥方式是用二进制写入，或转成可移植字符串。
- 推荐方案：用
std::to_string()存为文本（如"123456789"），再用std::stoll()读回，兼容所有标准库实现 - 避免用
fprintf(fp, "%ld", pos)——std::streamoff无固定 printf 格式符，%ld在 64 位系统上可能截断 - 保存位置的文件建议加扩展名如
.offset，并和原文件同目录，便于管理
示例保存逻辑：
std::ofstream offset_file("data.bin.offset");
offset_file << std::to_string(file.tellg());
offset_file.close();
重启读取时用 seekg() 跳转必须配合 clear()
如果之前读到了文件末尾（eofbit 置位），直接 seekg() 不会自动清除状态标志，后续读取会立即失败。这是最常被忽略的坑。
立即学习“C++免费学习笔记（深入）”；
- 每次
seekg()前必须调用file.clear()，重置failbit和eofbit -
seekg()后应检查是否成功：if (!file.seekg(pos)) { /* 失败，位置越界或文件被截断 */ } - 不要依赖
seekg(pos, std::ios::beg)的默认参数——显式写出更清晰，避免误用std::ios::end
典型恢复流程：
std::streamoff last_pos = /* 从 .offset 文件读出 */;
file.clear(); // 必须！
if (!file.seekg(last_pos)) {
// 处理错误：文件变小了，或 offset 文件损坏
}
实际传输中如何避免重复或漏读（边界控制）
断点续传不是简单跳过去就完事——你得确保“已处理”和“待处理”的边界绝对清晰。尤其当数据按块（如 4KB）读取时，最后一块可能只读了一半就中断。
- 记录偏移量的时机很重要：应在**一块数据完整处理完毕后**再更新 offset 文件，而不是每次
read()后就写 - 若程序崩溃在写 offset 文件中途，会导致下次多读——可用临时文件 +
rename()原子更新（Linux/macOS）或MoveFileEx()（Windows） - 对结构化数据（如 JSON 行、Protobuf 消息），建议在每条记录开头写长度字段，靠解析失败来检测断点是否落在记录中间，而非盲目信任偏移量
真正难的不是跳转，而是确认“这个偏移量对应的是完整记录的起点”。这需要协议层配合，不是 seekg() 单独能解决的。
