核心代码# 索引边界校验, 确保索引在合法范围. [0, self.sample_len - 1] index min(max(index, 0), self.sample_len - 1)作用把index限制在[0, self.sample_len - 1]范围内index 0→ 变成0index self.sample_len - 1→ 变成self.sample_len - 1在范围内 → 保持不变等价写法# 用 if 实现 if index 0: index 0 elif index self.sample_len: index self.sample_len - 1一行写法更简洁但可读性稍差看个人习惯。注意点1.self.sample_len为 0 时self.sample_len - 1 -1合法区间变成[0, -1]会出问题。需要先判断if self.sample_len 0: return # 或抛异常2.index是浮点数时min/max返回的仍是浮点数后续用index访问列表会报错。建议先转intindex int(index)3.越界被静默修正不会抛异常调试时可能忽略问题。需要日志的话可以加if index 0 or index self.sample_len: print(fWarning: index {index} clamped)适用场景数据读取时防止下标越界滑动窗口、采样时的索引保护任何需要安全访问列表/数组的地方