TextDecoder流式解码需复用实例并启用stream模式：创建一次const decoder = new TextDecoder("utf-8")，对每个Uint8Array调用decoder.decode(chunk, {stream: true})，末次调用无参数以清空缓冲区。
TextDecoder 可以高效处理流式文本数据块，关键在于复用解码器实例、正确处理字节边界，并累积未完成的 UTF-8 序列。
复用同一个 TextDecoder 实例
TextDecoder 是无状态的（除内部缓冲外），但每次新建实例会重置其内部缓冲区。流式解析时必须复用同一个实例，否则多字节字符（如中文、emoji）跨块时会解码失败。
- ✅ 正确：创建一次
const decoder = new TextDecoder("utf-8")，在每次收到 chunk 后调用decoder.decode(chunk, { stream: true }) - ❌ 错误：为每个 chunk 新建 TextDecoder，导致前一块末尾的不完整 UTF-8 字节被丢弃
启用 stream 模式并传入 Uint8Array
TextDecoder.decode() 的第二个参数为选项对象，{ stream: true } 告诉解码器“这可能不是完整数据”，它会保留未完成的多字节序列到内部缓冲区，等待下一次调用。
- 输入必须是
Uint8Array（或 ArrayBuffer / DataView），不能是普通数组或字符串 - 例如从 Fetch ReadableStream 读取：
const chunk = await reader.read(); if (chunk.value) text += decoder.decode(chunk.value, { stream: true }); - 注意：最后一次调用应省略
{ stream: true }或显式传{ stream: false }，确保清空缓冲区（如需收尾）
处理二进制流（如 fetch + ReadableStream）
实际场景中，流式文本常来自网络响应体。需配合 getReader() 和循环读取，避免阻塞。
- 使用
response.body.getReader()获取流读取器 - 在
while循环中调用reader.read()，对每个value（即 Uint8Array）执行decoder.decode(value, { stream: true }) - 别忘了在循环结束后调用
decoder.decode()（无参数）来处理残留缓冲字节（如最后一个不完整字符）
常见陷阱与应对
UTF-8 编码下，一个字符可能占 1–4 字节。若一个汉字（如 “你好”）被切在两个 chunk 中间（如 chunk1 以 0xE4 0xBF 结尾，chunk2 以 0xA0 开头），只有启用 stream: true 并复用 decoder 才能正确拼接还原。
- 错误表现：出现 符号、乱码或丢失字符
- 调试建议：打印每个 chunk 的字节长度和前/后几个字节，确认是否在多字节字符中间截断
- 补充：若服务端使用非 UTF-8 编码（如 GBK），需改用对应 label（如
new TextDecoder("gbk")），但浏览器原生仅支持 UTF-8、UTF-16、ISO-8859 等有限编码
