arrays.binarysearch要求数组已升序排列，否则结果不可靠；必须匹配类型重载版本；返回值需用result>=0判断存在性，插入点用-(result+1)还原；降序查找须配合对应comparator。
Arrays.binarySearch 不是“查不到就返回 -1”的简单工具，它对输入有严格前提，返回值自带位置语义。用错就会看似运行正常，实则结果不可靠——尤其在未排序数组、类型误用或降序场景下。
数组未排序是最常见也最危险的错误
binarySearch 假设数组已升序排列，不验证、不提示、不报错，只按二分逻辑硬算。一旦数组乱序，中间元素失去划分左右区间的资格，搜索路径完全失真。
- 查找存在的元素可能返回负数（伪失败）
- 查找不存在的元素可能碰巧返回正索引（伪命中），但无法复现
- 返回的负数不再表示有效插入点，-(result + 1) 还原出的位置毫无意义
- 典型误操作：从数据库/文件读取后直接查，忘了调 Arrays.sort()；或排序后又修改了某个元素，破坏有序性
类型与重载版本选错导致编译失败或运行异常
Java 为基本类型和引用类型提供了独立重载，不能混用。自动装箱/拆箱不作用于整个数组，类型不匹配会直接中断流程。
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 查 int[] 必须用 Arrays.binarySearch(int[], int)；传 Integer[] 却调用这个版本会编译报错
- 查 String[] 或自定义对象数组，必须确保元素实现 Comparable，或显式传 Comparator；否则运行时抛 NullPointerException
- 对基本类型数组误用 Object 版本（如 binarySearch(Object[], Object)），编译不通过
- 性能差异明显：百万级 int[] 上，用对重载比错用快 3–5 倍
忽略返回值真实含义，误判存在性或错用插入点
返回值不是布尔开关，而是带坐标的整数。用 result != -1 判断“是否找到”是高频错误，因为未找到时可能是 -2、-5、-100……
- 正确判断存在性：if (result >= 0)，而非 if (result != -1)
- 还原插入点必须用 -(result + 1) 或 ~result；用 Math.abs(result) 或 -result 会多加 1，位置偏移
- 插入点恒在 [0, arr.length] 范围内，不会越界，可安全用于后续扩容或 ArrayList.add(insertionPoint, key)
- 若需找重复元素的左边界（首个匹配位置），binarySearch 不保证返回它，需额外向左扫描或换用其他策略
降序数组与 Comparator 使用不一致
binarySearch 默认只认升序。传入降序数组却不配 Comparator，等同于输入错误地图——算法照跑，结果全错。
- 降序查找必须同时满足两个条件：数组用 Collections.reverseOrder() 排过序，且 binarySearch 调用时传同一个 Comparator
- Comparator 不仅影响比较结果，还决定“大于走右、小于走左”的分支逻辑；排序和查找用不同 Comparator，结果必然失效
- 基本类型数组（如 int[]）不支持传 Comparator，只能先转成 Integer[] 再操作，注意装箱开销
- 对 List 查找，请用 Collections.binarySearch(list, key)，而非 Arrays.binarySearch —— 后者只接受数组，对 ArrayList 传参会编译失败
