Redis中的GETRANGE命令用于返回存储在指定键中的字符串值的子串，通过给定起始和结束偏移量来界定范围。这个命令在需要局部读取长字符串、做分页展示或者提取固定格式内容中的某一段时非常实用。它属于字符串数据类型下的操作，执行时不修改原键的值，也不会因为超出长度而报错，而是尽可能返回有效部分。
GETRANGE基础语法与索引规则
GETRANGE的调用形式非常直观，基本写法为GETRANGE key start end。其中start和end都是整数索引，且区间是闭区间，也就是包含两端位置上的字符。Redis的字符串底层以字节序列保存，但GETRANGE按照字符偏移来计数，对于ASCII内容一个字符即一个偏移，而对UTF-8中文这类多字节字符，一个汉字占据多个偏移位，使用时要格外小心。
索引支持负数，规则是从字符串末尾向前数，-1代表最后一个字符，-2代表倒数第二个，以此类推。比如字符串"Hello"的长度是5，索引0是H，4是o，而-1同样是o，-5是H。当给出的start大于字符串长度，命令直接返回空字符串；当end超出末尾，则自动取到最后一个字符为止，不会发生越界异常。
我们可以通过一段简单例子观察行为。下面代码在Redis客户端中先写入一个值，再分别用正数和负数索引截取：
SET mykey "Hello World" GETRANGE mykey 0 4 # 返回 "Hello" GETRANGE mykey -5 -1 # 返回 "World" GETRANGE mykey 6 20 # 返回 "World"，end超出长度自动截断
多字节字符与编码导致的截取陷阱
很多人在处理中文内容时发现GETRANGE截出了奇怪的结果，根源在于Redis的字符串是二进制安全的字节串，GETRANGE按字节偏移而非按字符计数。如果存入的是UTF-8编码的中文，每个汉字通常占3个字节，当你用GETRANGE key 0 2想取第一个字时，实际只拿了该字的前两个字节，反序列化出来就是乱码或空。
要避免这种问题，要么在应用层以字节长度计算偏移，要么在写入前将内容转为ASCII安全的编码（如Base64），要么使用Redis的JSON等扩展结构配合专门路径查询。下面示例展示中文被截半的现象：
SET cn "你好" # UTF-8下"你"占3字节，"好"占3字节 GETRANGE cn 0 2 # 只取"你"的前两字节，客户端常显示为乱码 GETRANGE cn 0 5 # 取到"你"完整加"好"前两字节，仍残缺
如果业务必须存原文且按字符截取，推荐在客户端用编程语言先按字符切片，再写入独立键，或者将字符串用特定分隔符分段存储。这样虽然牺牲了一点原子性，但规避了底层字节错位。另外注意，GETRANGE不会因键不存在而报错，而是返回空串，这和GET对不存在键返回nil在类型上不同，程序里要区分空串与nil。
GETRANGE与相似命令的性能及适用对比
除了GETRANGE，Redis还提供SUBSTR作为旧版别名，两者行为一致，但官方文档建议新代码用GETRANGE。另一个常见做法是先用GET取全量再在客户端截取，这在短字符串上差异不大，但面对几MB的大值，全量传输会消耗大量带宽与内存，此时GETRANGE的服务器端截取优势明显，它只返回所需片段，网络开销大幅下降。
从时间复杂度看，GETRANGE为O(N)，N是返回子串的长度，而非原串长度，因此即便原串很大，只要截取范围小，依然很快。下面的表格简要对比三种读取局部内容的方式：
| 方式 | 网络传输量 | 服务端开销 | 适用场景 |
|---|---|---|---|
| GET全量+客户端截 | 原串全部 | 低 | 原串很小或需整体处理 |
| GETRANGE | 仅子串 | O(N)子串长度 | 大字符串局部读取 |
| SUBSTR | 仅子串 | 同GETRANGE | 兼容老版本代码 |
在集群模式下，GETRANGE只涉及单个键，因此不会触发跨槽操作，只要键有明确归属节点即可正常执行。若键被频繁整体覆盖又偶尔局部读，要考虑写放大问题，因为Redis字符串修改通常是复制新值。对于超高并发只读子串场景，可配合副本节点分担流量，利用GETRANGE的只读特性提升吞吐。
实际应用中的错误处理与最佳实践
在代码里调用GETRANGE时，应当先确认键的类型是字符串，否则对列表或哈希类型调用会返回WRONGTYPE错误。利用TYPE命令预检，或捕获异常做降级，是保证健壮性的基本动作。另外，由于GETRANGE返回的是字符串，调用方需自行判断空串是否代表“无数据”还是“数据为空”，必要时用EXISTS辅助区分。
以下Python片段展示如何安全调用并规避类型错误：
import redis
r = redis.Redis(host='127.0.0.1', port=6379, db=0)
if r.type('mykey') == b'string':
sub = r.getrange('mykey', 0, 4)
print(sub.decode('utf-8', errors='replace'))
else:
print('key not string or missing')
最后，建议在文档中显式标注存入内容的编码，团队内统一约定偏移计算规则。若子串范围由用户输入决定，必须校验start和end，防止负数与正数混用造成逻辑漏洞。GETRANGE本身简单，但和业务编码、传输协议结合起来，就需要上述工程化约束，才能在长期维护中少出故障。