std::ranges::equal_range要求范围已排序且比较器满足严格弱序，否则行为未定义；返回左闭右开迭代器对，支持投影功能。
std::ranges::equal_range要求范围必须已排序
直接调用 std::ranges::equal_range 时，如果传入的容器未排序，行为是未定义的——它不会报错，但返回的迭代器对可能完全错乱，比如 first 指向末尾而 last 指向开头。这不是“结果不准”，而是标准明确禁止的行为。
常见误用场景：对 std::vector<int>{5, 2, 8, 2, 1}</int> 直接搜 2，得到的范围可能不包含所有 2，甚至为空。
- 确认排序：用
std::ranges::is_sorted(v)在调试时快速验证（发布版可移除） - 若需动态插入后保持有序，优先考虑
std::set或std::multiset，而非反复排序 +equal_range - 排序键要和搜索键一致：比如按
.id排序的vector<person></person>，就得用equal_range(..., {}, &Person::id)，不能用.name
自定义比较器必须满足严格弱序
传入的 comp 参数（第三个参数）若写成 (a, b) { return a 或 <code>a == b，会导致 equal_range 内部二分逻辑崩溃——可能无限循环、越界解引用，或返回空范围。
典型错误示例：equal_range(v, 42, [](int x, int y) { return x —— 这违反了严格弱序中“不可比性必须对称”的要求。
- 正确写法永远是
a （升序）或 <code>a > b（降序），不要带等号 - 对结构体，确保比较器不依赖未初始化字段，也不调用可能抛异常的函数
- 若用
std::less或默认比较，编译器会自动推导；显式写 lambda 时务必检查签名是否为bool(Args...)
返回值不是“找到了几个”，而是两个迭代器
std::ranges::equal_range 返回的是 std::ranges::subrange<it it></it>（C++20 起），本质是 {first, last} 迭代器对，区间为左闭右开：[first, last)。它的长度才是匹配元素个数，即 std::ranges::distance(result)。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
别直接用 result.first == result.last 判断“没找到”——这没错，但更常见的是需要遍历结果，或取第一个匹配项：
- 判空：用
result.empty()最清晰 - 取首个匹配：
if (!result.empty()) { auto& first_match = *result.begin(); } - 批量处理：直接
for (auto& x : result) { ... }，无需手动 ++ 迭代器 - 注意：若范围是
std::vector，result中的迭代器仍有效；但若原容器被移动或销毁，它们立刻失效
与 std::equal_range 的关键差异：支持投影（project）
C++20 的 std::ranges::equal_range 多了一个可选的 proj 参数（第四个），能对每个元素预处理后再比较。这是老版 std::equal_range 完全没有的能力。
例如在 vector<string></string> 中按长度搜所有长度为 3 的字符串，不用额外建索引或临时 vector：
auto r = std::ranges::equal_range(v, 3, {}, &std::string::size);
这里 {} 表示用默认比较（== 和 ），<code>&std::string::size 是投影——每次比较前先取 string.size()。
- 投影函数必须无副作用、不修改元素、且返回类型可与搜索值比较
- 投影 + 自定义比较器可组合：比如按字符串小写形式比较，就用
equal_range(..., {}, [](const string& s) { return to_lower(s); }) - 若投影涉及耗时计算（如解析 JSON 字段），注意它会在二分过程中被多次调用，考虑缓存
{} 会导致编译器把投影当成比较器，报一堆难以定位的模板错误。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
