atob 解码中文会出错是因为它仅支持 ISO-8859-1 字节流，将 UTF-8 编码的多字节中文错误拆分为单字节 Latin-1 字符，导致乱码或 DOMException 错误。
atob 本身不支持 Unicode 字符，直接解码含中文、emoji 等的 Base64 字符串会报错或乱码；必须配合额外的字符编码转换逻辑才能正确还原。
为什么 atob 解码中文会出错
atob 只处理 ISO-8859-1（Latin-1）字节流，它把 Base64 解出来的每个字节直接映射为一个 16 位 JS 字符。当原始字符串是 UTF-8 编码的中文时，一个汉字占 3 个字节，atob 会错误地将这 3 个字节拆成 3 个独立的 Latin-1 字符，再交给 JS 引擎解释——结果就是乱码或 DOMException: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded. 错误。
用 decodeURIComponent + escape 组合还原 UTF-8
这是兼容性最广、无需依赖现代 API 的方案，核心思路是：先让 atob 输出 Latin-1 字符串，再把它“假装”成 URL 编码格式，用 decodeURIComponent 强制按 UTF-8 解释。
- 不能直接用
unescape(atob(str))：ES2023+ 已废弃unescape，且它不处理多字节 UTF-8 - 必须走
escape→decodeURIComponent这条链：因为escape会把非 ASCII 字符转成%xx%yy%zz格式，而decodeURIComponent能正确识别并还原为 UTF-8 字符 - 示例代码：
function base64DecodeUnicode(str) {
return decodeURIComponent(escape(atob(str)));
}
// 测试：5L2g5aW9 是 “你好” 的 Base64
console.log(base64DecodeUnicode('5L2g5aW9')); // 输出：你好
用 TextDecoder 替代 escape + decodeURIComponent
更现代、语义更清晰的方式，适合目标环境支持 TextDecoder（Chrome 49+/Firefox 44+/Safari 10.1+/Node.js 11.0+）。
-
TextDecoder('utf-8')直接按字节流解码，绕过 JS 字符编码陷阱 - 需手动把
atob结果转成Uint8Array：因为atob返回的是字符串，每个字符对应一个字节值，用.charCodeAt(i)提取即可 - 注意：不要传入空字符串或非法 Base64，
atob会抛异常，建议外层加 try/catch
function base64DecodeTextDecoder(str) {
const bin = atob(str);
const bytes = new Uint8Array(bin.length);
for (let i = 0; i < bin.length; i++) {
bytes[i] = bin.charCodeAt(i);
}
return new TextDecoder().decode(bytes);
}
编码端必须与解码端对称
前端用上述任一方式解码，那编码端就必须用对应的 UTF-8 编码逻辑，否则必然失败：
- 错误做法：
btoa('你好')→ 直接报错，因为btoa同样只接受 Latin-1 字符串 - 正确编码方式（与上面
base64DecodeUnicode对应）：
function base64EncodeUnicode(str) {
return btoa(unescape(encodeURIComponent(str)));
}
这个组合确保了：原始字符串先被 encodeURIComponent 转成 UTF-8 %xx 形式，unescape 把它变回 Latin-1 字节流，btoa 才能安全编码。整个链条和解码端完全镜像。
最容易被忽略的是：前后端若混用不同编码路径（比如前端用 TextDecoder 解，后端却用 Python 的 base64.b64encode(s.encode('latin-1'))），结果一定错——Base64 本身没状态，但它的输入字节序列必须严格一致。
