*Redis LSET 命令
设置 List 中指定索引位置的元素值。
*语法
LSET key index element
*参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | String | 是 | List 的键名 |
| index | Integer | 是 | 索引，0 表示第一个，-1 表示最后一个 |
| element | String | 是 | 新元素值 |
*返回值
| 条件 | 返回值 |
|---|---|
| 设置成功 | OK |
| index 超出范围 | 错误 ERR index out of range |
| key 不存在 | 错误 ERR no such key |
*时间复杂度
O(N)，N 为遍历的元素数量。接近两端时较快。
*示例
> RPUSH mylist a b c
(integer) 3
> LSET mylist 0 "updated"
OK
> LRANGE mylist 0 -1
1) "updated"
2) "b"
3) "c"
> LSET mylist -1 "last"
OK
> LRANGE mylist 0 -1
1) "updated"
2) "b"
3) "last"
*常见错误
| 错误 | 原因 | 解决 |
|---|---|---|
| index 越界 | 索引超出当前 List 范围 | 确认索引在有效范围内 |
| key 不是 List | 对非 List 类型执行 | 确认 key 存在且类型为 List |
| 负数索引理解错误 | -0 指向最后一个元素 | 正确理解负数索引语义 |
*最佳实践
- 固定长度数组：用 List 实现固定长度数组，LSET 更新指定位置。
注意性能：链表结构，中间位置修改需要 O(N) 遍历。
避免大 List 中间修改：List 长度超过 10,000 时，中间位置修改性能显著下降，考虑改用其他数据结构。
*5. 使用 LPUSHX/RPUSHX 预初始化：确保 List 已存在且长度足够，避免 LSET 因越界失败。
*FAQ
Q1: LSET 可以自动扩展 List 吗？
A: 不可以。LSET 只能修改已存在的索引位置，index 超出当前 List 范围会返回 ERR index out of range。需要扩展请使用 LPUSH/RPUSH。
Q2: LSET 修改中间元素会很慢吗？ A: 是的。Redis List 是双向链表，修改中间元素需要 O(N) 遍历。如果频繁随机访问中间元素，建议改用 Hash 或 String 结构。
Q3: 负数索引在 LSET 中怎么理解？ A: -1 表示最后一个元素，-2 表示倒数第二个，以此类推。LSET 支持负数索引，方便从尾部定位。
Q4: LSET 和 LRANGE 配合使用有什么注意事项？ A: LRANGE 获取元素后，如果其他客户端修改了 List（删除/插入元素），原索引位置可能指向不同的元素甚至越界。高并发场景建议配合锁或 Lua 脚本。
Q5: 为什么 LSET 时间复杂度是 O(N) 而不是 O(1)？ A: 因为 Redis List 采用链表实现，没有随机访问能力。需要通过索引遍历到目标节点，遍历距离决定了实际开销。