np.searchsorted适用于已排序升序数组的插入位置查找，用于分段映射、区间查找等；不适用于未排序或降序数组，否则结果不可靠。
np.searchsorted 适合什么场景
它不是用来找“某个值是否存在”，而是找“如果要把这个值插进去，该放在哪”——也就是返回插入位置索引。常用于已排序数组的定位，比如分段映射、区间查找、离散化坐标转换等。如果你手头的数组没排好序，np.searchsorted 的结果是错的，它不会帮你排序，也不会报错，只会默默返回一个无意义的位置。
必须保证输入数组升序，否则结果不可靠
np.searchsorted 默认只支持升序数组。遇到降序数组会直接失效；遇到乱序数组，行为未定义（通常返回错误索引）。你可以用 np.argsort 预处理，但更常见的做法是先确认排序状态：
- 检查是否升序：
np.all(arr[:-1] - 若需支持降序，手动反转数组 + 反转索引：
len(arr) - np.searchsorted(arr[::-1], val) - 不要依赖
side='right'来“修复”乱序问题——它只控制相等时的插入倾向，不解决根本排序问题
side='left' 和 side='right' 的实际区别
当查找值在数组中存在多个重复时，这两个参数决定返回最左还是最右的那个位置：
arr = np.array([1, 2, 2, 2, 3, 4]) np.searchsorted(arr, 2, side='left') # → 1 np.searchsorted(arr, 2, side='right') # → 4
注意：side='right' 返回的是“插入到最右一个 2 后面”的位置，不是最后一个 2 的索引。所以想取最后一个匹配索引，得减 1；想取第一个匹配索引，就用 side='left'。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
查不到时返回什么？怎么安全使用
即使值不在数组中，np.searchsorted 也总会返回一个合法索引（0 到 len(arr)），不会抛异常。这意味着你不能靠捕获异常来判断是否存在——得自己做边界检查：
- 想确认值是否存在：先查
left_idx = np.searchsorted(arr, x, side='left')，再判断left_idx - 想查区间归属（如分箱）：直接用返回值作为 bin index，只要确保
x在数组值域内，或提前 clip 处理越界值 - 性能上，它比
np.where(arr == x)[0]快得多，尤其是大数组，因为后者是线性扫描
最容易被忽略的一点：它返回的是索引，不是布尔值或元素本身。用错类型（比如当成 True/False 传给 if）会导致静默逻辑错误。
