collections.binarysearch用于已升序排序的list进行o(log n)二分查找,要求列表预先排序且comparator一致;返回≥0为索引,<0时绝对值减1为插入点;不适用于set/map,数组需用arrays.binarysearch。

Collections.binarySearch 是 Java 中对已排序集合进行快速查找的工具方法,它不自己排序,只在已升序排列的 List(如 ArrayList、LinkedList)上执行二分搜索,时间复杂度为 O(log n),远优于线性遍历的 O(n)。
前提条件:必须确保列表已排序
binarySearch 不会检查或自动排序输入列表。若传入未排序或降序排列的 List,结果不可预测,可能返回负数(表示插入点),但该值无实际意义。
- 升序排序推荐用 Collections.sort(list) 或创建时就用有序结构(如 TreeSet 转 ArrayList)
- 若列表按自定义规则排序,调用时必须传入对应的 Comparator,且该 Comparator 必须与排序时使用的一致
- 对 String、Integer 等自然序类型,可直接调用无 Comparator 版本
返回值含义要准确理解
方法返回 int 类型:
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
- ≥ 0:表示目标元素在列表中的索引位置
- < 0:表示未找到,其绝对值减 1 是该元素“应插入的位置”,即维持升序所需的下标(例如返回 -3,说明应在索引 2 处插入)
- 注意:插入点可能超出当前列表长度(如返回 -list.size()-1),此时意味着应插在末尾
支持泛型和自定义比较器
方法签名包含类型参数,能安全处理任意引用类型:
-
Collections.binarySearch(List
list, T key) —— 使用元素自然顺序 -
Collections.binarySearch(List
list, T key, Comparator super T> c) —— 使用指定比较逻辑 - Comparator 实现需满足一致性:对相同对象多次比较结果必须相同;不能抛出异常;要符合数学上的全序关系(自反、传递、反对称)
替代方案与注意事项
binarySearch 仅适用于 List,不支持 Set 或 Map。若需频繁查找,可考虑:
- 用 TreeSet 替代 ArrayList + binarySearch,它底层是红黑树,增删查均为 O(log n),且自动维护有序
- 对静态只读数据,排序后用 binarySearch 非常高效;但若需频繁插入/删除,维护有序成本高,应权衡是否改用哈希结构
- 数组查找请用 Arrays.binarySearch(),二者行为一致,只是操作对象不同
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










