因为范围for循环依赖begin()/end()函数，而自定义容器需提供成员版（优先）或adl可见的自由函数；二者必须成对提供const/non-const版本，返回满足迭代器概念的类型，并确保const正确性与生命周期一致。
为什么你的自定义容器调用 for (auto x : container) 报错？
因为编译器在范围 for 循环里会隐式调用 begin() 和 end()，而它们默认只认标准容器或 ADL 找到的自由函数。如果你的类没提供成员版 begin()/end()，也没声明匹配的自由函数，就会触发 error: no matching function for call to 'begin'。
最直接、最推荐的做法是实现成员函数——它优先级最高，语义清晰，且不依赖 ADL 查找规则。
-
begin()和end()必须返回满足迭代器概念的类型（至少支持operator!=、operator*、operator++） - 必须成对提供 const 版本：否则
const Container c; for (auto x : c)会失败 - 返回类型建议用
iterator/const_iterator别名，而不是裸指针（除非你真用指针当迭代器）
如何写一个最小可用的 begin()/end() 成员函数？
假设你有一个内部数组的简单容器：
template<typename t>
class MyVector {
T* data_;
size_t size_;
public:
using iterator = T*;
using const_iterator = const T*;
<pre class="brush:php;toolbar:false;">iterator begin() { return data_; }
iterator end() { return data_ + size_; }
const_iterator begin() const { return data_; }
const_iterator end() const { return data_ + size_; }
};
注意四点：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 返回类型必须和你迭代器的实际类型一致；用
using别名能避免硬编码、方便后续替换 - 非 const 成员函数返回非 const 迭代器，const 成员函数返回 const 迭代器——这是 const 正确性的基础
- 不要返回
std::vector::iterator这类类型（除非你内部真的用std::vector），容易造成类型不匹配 - 如果迭代器是自定义类（比如封装了指针+边界检查），确保它重载了必要操作符，否则范围 for 无法编译
什么时候该用自由函数而非成员函数？
只有两种合理场景需要自由函数：你无法修改类定义（比如为第三方 struct 添加迭代支持），或想统一支持多种容器类型（如泛型算法库）。否则一律优先成员函数。
自由函数写法示例（针对不可改的旧结构）：
struct CArray {
int* ptr;
size_t n;
};
<p>// 在同一命名空间内，或在 std 命名空间（仅限特化 std::begin/std::end，且需满足严格条件）
int<em> begin(CArray& c) { return c.ptr; }
int</em> end(CArray& c) { return c.ptr + c.n; }
const int<em> begin(const CArray& c) { return c.ptr; }
const int</em> end(const CArray& c) { return c.ptr + c.n; }</p>
关键限制：
- 自由函数必须和类在同一个命名空间，才能被 ADL 正确找到
- 不能随便往
std里加begin——只有对用户定义类型特化std::begin才合法，且必须在定义该类型的头文件中完成 - 如果同时存在成员和自由函数，成员函数永远胜出；但混用容易引发歧义，不建议
迭代器失效和 end() 的常见坑
end() 不是“最后一个元素”，而是“尾后位置”——这个理解偏差会导致越界或漏遍历。
- 若容器支持
push_back，end()返回值可能随插入失效（比如内部 realloc 后指针变无效），此时每次循环前都应重新调用end() - 别把
end()存成变量再用于比较：auto e = c.end(); for (auto it = c.begin(); it != e; ++it)—— 如果循环中容器被修改，e就变成悬垂指针 - 自定义迭代器若带状态（如引用计数、锁），
end()构造时也要保证状态一致性，否则it != end()可能行为异常
真正麻烦的从来不是写那两行函数，而是让迭代器语义和容器生命周期对齐。尤其是带内存管理或线程安全的容器，begin()/end() 的实现得和析构、移动、拷贝全部咬合住。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
