range-based for要求begin()和end()以获取迭代器范围；它优先通过ADL查找非成员函数，再回退到成员函数，推荐在同命名空间定义inline非模板版本以支持ADL和const重载。
为什么 range-based for 要求 begin() 和 end()？
range-based for（如 for (auto& x : container)）底层会尝试在作用域内查找 begin(container) 和 end(container) —— 它**不强制要求容器本身有成员函数**，而是先查 ADL（Argument-Dependent Lookup）可见的非成员函数，再 fallback 到成员调用。所以你有两种合法路径：定义自由函数，或添加成员函数。
如何实现非成员 begin()/end()（推荐）
这是更通用、更符合 STL 风格的做法，尤其适合你无法修改类定义（比如第三方类型）或想保持接口分离的场景。关键点是让函数和类在同一个命名空间，触发 ADL。
- 函数必须是非模板（或显式特化），且参数类型精确匹配你的自定义类型（不能是 const 重载遗漏）
- 返回类型必须满足迭代器要求：支持
operator!=、operator*、operator++等 - 若希望支持
const容器遍历，需额外提供const版本
namespace mylib { struct MyRange { int* data; size_t size; }; // 非成员 begin/end（ADL 可见） inline int begin(MyRange& r) { return r.data; } inline int end(MyRange& r) { return r.data + r.size; } inline const int begin(const MyRange& r) { return r.data; } inline const int end(const MyRange& r) { return r.data + r.size; } }
为什么加 inline？
避免在多文件中定义重复符号。c++17 起也可用 inline 函数模板，但对简单类型，非模板 + inline 更轻量、无推导开销。若你用模板版本，必须确保定义在头文件中，且所有使用点都能看到完整定义：
template inline auto begin(MyRangeT& r) { return r.begin(); } template inline auto end(MyRangeT& r) { return r.end(); }
注意：模板版本容易因 SFINAE 或推导失败静默失效，调试时不如非模板直观。
立即学习“C++免费学习笔记（深入）”；
成员函数方式的陷阱
如果坚持写 container.begin()，务必确认：它不能是 const-qualified 但返回非 const 迭代器——否则 const MyRange r{}; for (auto x : r) 会编译失败。
- 正确：提供
begin() const和end() const成员，返回const_iterator - 错误：只写
begin()（非 const），却没配begin() const - 更隐蔽的坑：返回
int*的成员函数被误认为“可修改底层数据”，而实际语义是只读遍历——这时应返回const int*或自定义const_iterator
ADL 方式天然规避了 const 重载问题，因为你可以独立控制每个重载的签名。
最容易被忽略的一点
begin() 和 end() 的返回类型不必相同，但必须能用 != 比较（例如 iterator 和 sentinel 类型，C++20 范围库常见）。不过在 C++11/14 下，绝大多数情况仍要求两者为同一类型。如果你返回不同类型，range-based for 可能编译失败，且错误信息往往指向内部模板，很难定位到你自己的函数。