response.text() 返回 Promise，需 await 或 .then() 解包；调用后响应体被消耗，不可重复读取；中文乱码需检查 Content-Type charset；大文本应避免直接使用 text()，改用流式处理。
response.text() 返回的是 Promise，不是字符串
调用 response.text() 后拿到的永远是一个 Promise，不是立即可用的文本。直接打印或赋值给字符串变量会看到 [object Promise] —— 这是最常见的误用起点。
必须用 await 或 .then() 解包：
const response = await fetch('/api/log');
const text = await response.text(); // ✅ 正确：等待 Promise resolve
console.log(text); // 真实的纯文本内容
如果在非 async 函数里用，就得写成：
fetch('/api/log')
.then(res => res.text())
.then(text => console.log(text));
text() 会消费响应体，不可重复调用
response.text()、response.json()、response.blob() 都属于“读取方法”，它们会把响应流消耗掉。一旦调用过 response.text()，再调用一次就会得到空字符串，再调 response.json() 则抛错 TypeError: Failed to execute 'json' on 'Response': body stream is locked。
立即学习“前端免费学习笔记（深入）”；
- 只选一个读取方法，按需使用
- 若需多种格式（比如既要 log 又要解析），应先用
response.clone()复制响应对象 -
response.clone()必须在任何读取方法调用前执行
const response = await fetch('/data');
const text = await response.text(); // 消耗原始响应
const json = await response.clone().json(); // 克隆后读取 JSON
中文乱码？检查 Content-Type 响应头中的 charset
浏览器默认按 UTF-8 解码 text()，但如果服务端返回的 Content-Type 是 text/plain 且没带 charset=utf-8，而实际内容是 UTF-8 编码，某些旧环境（如部分 Electron 版本或 IE 兼容模式）可能误判为 ISO-8859-1，导致中文变问号或乱码。
- 优先让后端设置响应头：
Content-Type: text/plain; charset=utf-8 - 前端无法改服务端时，可手动解码（不推荐，仅应急）：先用
response.arrayBuffer()，再用TextDecoder
const buffer = await response.arrayBuffer();
const text = new TextDecoder('utf-8').decode(buffer); // 绕过自动 charset 推断
大文本响应下 text() 可能阻塞主线程
response.text() 是全量加载并解码整个响应体到内存，对几 MB 以上的纯文本（如日志文件、CSV 内容），会造成明显卡顿，甚至触发浏览器内存警告。
- 确认是否真需要全部加载：能否用流式处理（
response.body+ReadableStream）逐块读？ - 服务端支持的话，优先用分页、limit 参数控制返回体积
- Node.js 环境无此问题；但浏览器中，尤其移动端，2MB+ 文本建议评估替代方案
流式读取示例（简化）：
const reader = response.body.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) break;
const chunk = new TextDecoder().decode(value);
console.log('chunk:', chunk);
}
真正的大文本场景，别只盯着 text() —— 它方便，但不是万能解药。
