c++oding="utf-8" ?>
95%场景用std::ifstream&；仅需接管并消耗流时才用std::ifstream&&，因移动后原对象状态未定义，易致静默失败。
函数参数该用 std::ifstream& 还是 std::ifstream&&
直接说结论：95% 的场景下，传 std::ifstream& 就够了；只有明确要“接管并消耗流对象”时，才考虑 std::ifstream&&。别一上来就写移动语义——std::ifstream 移动后原对象进入有效但未定义状态，后续再读会静默失败或触发 failbit。
常见错误现象：std::ifstream 传值（std::ifstream）导致编译报错，因为拷贝构造被显式删除；传右值引用却在函数内反复使用原对象，结果第二次读不到内容。
- 使用场景：读配置、解析日志、批量处理文件——这些都只需观察/消费流，不改变其所有权
-
std::ifstream&允许复用已打开的流，也兼容左值和绑定到临时对象的 const 引用（如func(std::ifstream{"a.txt"})不合法，但加const&可延长生命周期） -
std::ifstream&&真正有用的地方极少，比如封装一个“打开即移交”的工厂函数：auto make_reader(std::string path) { return std::ifstream{path}; }，再用process(std::move(f))传入
传引用时必须检查 is_open() 和 good()
很多人以为传了引用就万事大吉，结果函数里直接 getline() 却卡住或返回空——因为流可能根本没打开，或者之前操作已置位 failbit。引用不自动重试、不自动清错，它只是个“通道”。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 错误现象：函数开头没检查，读到一半才发现
stream.eof()为真，但其实是failbit导致的假 EOF - 正确做法：入口处先
if (!stream.is_open() || !stream.good()) return;，或抛异常 - 注意
good()和operator bool()等价，但fail()比!good()更精准（跳过eofbit干扰） - 不要依赖构造时的检查：流可能在传入前已被关闭（比如作用域提前结束），引用无法阻止这点
避免把 std::fstream 或 std::ofstream 当作 std::istream& 传参
看起来能编译通过，但容易埋雷。比如函数声明为 void parse(std::istream& is)，你传进 std::ofstream，它确实继承自 std::istream（虚继承），但实际是空的输入缓冲区——写入流没有输入能力，read() 总返回 0，eof() 立刻为真。
- 错误现象：传
std::ofstream给只读函数，不报错但逻辑永远走不到预期分支 - 类型应尽量精确：读文件用
std::ifstream&，写用std::ofstream&，通用接口才退化为std::istream&/std::ostream& - 如果真要泛化，优先用模板：
template<typename t> void process(T& stream)</typename>，编译期就能拦住不支持getline()的类型 - 性能影响：虚继承带来的间接调用开销极小，但语义混淆的代价远高于这点
移动语义真正生效的前提：对象必须可移动且未被绑定到 const 引用
你以为写了 void load(std::ifstream&& f) 就用了移动？不一定。如果调用方传的是具名变量（比如 std::ifstream f{"a.txt"}; load(f);），那还是调用左值引用重载——C++ 规则：具名变量默认是左值，哪怕类型是 &&。
- 必须显式用
std::move()：只有load(std::move(f))才触发移动构造 - 移动后原对象不可再用于 IO：标准只要求移动后
f.is_open() == false或处于未定义状态，不同 STL 实现行为不一致 - 兼容性风险：libstdc++ 和 libc++ 对移动后状态的处理略有差异，跨平台时尤其要小心
- 真正需要移动的典型场景：从容器里取出流对象并传递给处理函数，例如
auto f = std::move(files.back()); files.pop_back(); process(std::move(f));
最常被忽略的一点：移动语义解决的是“避免拷贝”，但 std::ifstream 本身不能拷贝，所以它真正优化的，只是内部句柄的转移——而这个转移，在绝大多数单次读取场景里，收益几乎为零。把心思花在检查流状态和选对引用类型上，比纠结移动更实在。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
