range-for要求容器提供begin()和end()成员函数，因其被编译器重写为for循环形式，需返回支持解引用、递增和不等比较的迭代器类型；必须成对提供const与非const版本，并确保迭代器满足基本操作要求。
为什么 range-for 要求容器有 begin() 和 end()
range-for 本质是编译器重写为类似 for (auto it = c.begin(); it != c.end(); ++it) 的形式，所以它不关心你是不是标准容器，只认这两个函数——而且要求返回可解引用、可递增、可比较的迭代器类型。如果你的自定义容器没提供，或者返回类型不满足要求，就会报错，比如 error: no match for 'operator!=' 或 no member named 'begin'。
begin()/end() 返回什么类型才合法
最直接的做法是返回一个类类型的迭代器（不能只是裸指针，除非你的数据是连续内存且满足所有操作），这个类至少要支持：
-
operator*和operator->（用于解引用） -
operator++（前缀，返回自身引用） -
operator!=（与同类型end()迭代器比较） - 默认构造（
end()常用空构造或哨兵值）
例如，一个简单动态数组容器：
template<typename t>
class MyVec {
T* data_;
size_t size_;
public:
struct iterator {
T* ptr_;
iterator(T* p) : ptr_(p) {}
T& operator*() { return *ptr_; }
iterator& operator++() { ++ptr_; return *this; }
bool operator!=(const iterator& other) const { return ptr_ != other.ptr_; }
};
iterator begin() { return iterator(data_); }
iterator end() { return iterator(data_ + size_); }
};</typename>
常量版本和 const 安全怎么加
不加 const 重载的话，对 const MyVec& 对象调用 range-for 会失败。必须成对提供：
-
iterator begin()/iterator end()（非 const 版本） -
const_iterator begin() const/const_iterator end() const
通常 const_iterator 可以复用 iterator 模板，用 const T* 实例化；或者直接 typedef：using const_iterator = iterator（仅当 iterator 内部用 const T* 且不提供非 const 解引用时才安全）。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
更稳妥的是显式定义两个迭代器类，或用模板参数区分可变性。
别忘了 using 别名和 ADL 友好性
标准库容器都提供 using iterator = ... 等类型别名，虽然 range-for 不强制依赖它们，但很多泛型算法（如 std::distance）会通过 std::iterator_traits 查找，所以建议补上：
using iterator = typename std::iterator_traits<iterator>::iterator_category;</iterator>
更重要的是：确保 begin()/end() 是成员函数。ADL（参数依赖查找）对非成员 begin() 也有效，但容易和 std::begin 冲突，尤其在 using namespace std; 时。成员版本更明确、更少歧义。
实际写的时候最容易漏掉 const 重载，或者迭代器里忘了实现 operator!=（误以为能靠指针隐式转换），这两处一出错，编译器报的错误信息往往绕得远，得往回查。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
