TextDecoder解码Uint8Array最轻量高效：一次性解码用response.arrayBuffer()转Uint8Array后decode；流式需复用实例并启用{stream:true}，末次调用decode()清缓冲。
直接用 TextDecoder 解码 Uint8Array 是最轻量、高效的方式，尤其适合处理 fetch 返回的原始二进制流（如 Response.arrayBuffer() 或 Response.body 流式读取）。关键在于明确数据编码（通常是 utf-8），并注意流式场景下的分块拼接问题。
从 fetch 获取 ArrayBuffer 后一次性解码
这是最常见也最稳妥的方式：先完整获取响应体为 ArrayBuffer，再转成 Uint8Array 交给 TextDecoder。
- 调用
response.arrayBuffer()得到完整二进制数据 - 用
new Uint8Array(buffer)创建视图（无需拷贝内存） - 用
new TextDecoder('utf-8').decode(uint8Array)解码为字符串
示例：
const response = await fetch('/api/data.txt');const buffer = await response.arrayBuffer();
const decoder = new TextDecoder('utf-8');
const text = decoder.decode(new Uint8Array(buffer)); // 直接解码
流式读取 body 并逐块解码（需处理边界截断）
当响应很大或需低延迟渲染时，可用 response.body.getReader() 流式读取 Uint8Array 块。但 UTF-8 多字节字符可能被切在块边界，必须启用 stream: true 选项让 TextDecoder 缓存不完整字符。
- 创建解码器时传入
{ stream: true } - 每收到一块
Uint8Array就调用decoder.decode(chunk, { stream: true }) - 最后一块调用
decoder.decode(undefined)（或decoder.decode()）清空残留
示例：
const response = await fetch('/large-file.txt');const reader = response.body.getReader();
const decoder = new TextDecoder('utf-8', { stream: true });
let result = '';
while (true) {
const { done, value } = await reader.read();
if (done) {
result += decoder.decode(); // 清空内部缓冲
break;
}
result += decoder.decode(value); // value 是 Uint8Array
}
console.log(result);
手动拼接 Uint8Array（适用于自定义分块逻辑）
若你通过其他方式（如 WebSocket、IndexedDB）获得多个 Uint8Array，需合并后再解码。注意：不能直接用 concat（它返回新数组，但类型是 number[]），应使用 TypedArray 的构造方式。
- 计算总长度，创建目标
Uint8Array(totalLength) - 用
.set(source, offset)逐个写入 - 再统一解码，避免流式开销
示例：
const chunks = [new Uint8Array([0xe4, 0xbd, 0xa0]), new Uint8Array([0xe5, 0xa5, 0xbd])]; // “你好”被拆开const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
const merged = new Uint8Array(totalLength);
let offset = 0;
for (const chunk of chunks) {
merged.set(chunk, offset);
offset += chunk.length;
}
const text = new TextDecoder('utf-8').decode(merged); // "你好"
注意事项与常见坑
解码行为依赖编码声明，实际使用中需确认服务端真实编码。
-
TextDecoder默认编码是'utf-8'，显式写出更安全 - 若响应头含
Content-Type: text/plain; charset=gbk，则需用new TextDecoder('gbk')（需浏览器支持，Chrome 支持 gbk/gb2312，Firefox 仅 utf-8 和少数编码） - 解码失败（如非法 UTF-8 序列）默认替换为
，可通过{ fatal: true }让其抛错 -
Uint8Array是视图，不持有原始数据；解码后字符串与原数组无引用关系
