未来之窗base64加解码

一、功能概述

未来之窗base64加解码提供一对互为逆运算的函数，用于在 UTF-8 原始字符串与 Base64 编码字符串之间进行转换。编码函数将任意文本按 UTF-8 字节序列编码为标准 Base64 字符串；解码函数将标准 Base64 字符串还原为原始 UTF-8 文本，可正确处理中文、Emoji 等多字节字符。

二、核心函数与调用格式

1. $cq.base64_encode

$cq.base64_encode(options);

编码函数，将输入的原始字符串按 UTF-8 编码后转换为标准 Base64 字符串。

2. $cq.base64_decode

$cq.base64_decode(options);

解码函数，将输入的标准 Base64 字符串还原为原始 UTF-8 文本。

三、参数说明

四、返回值

• $cq.base64_encode 返回标准 Base64 编码字符串，仅包含 A-Z、a-z、0-9、+、/ 及补位字符 =。
• $cq.base64_decode 返回解码后的原始 UTF-8 字符串。

五、使用示例

1. 编码示例：将文本编码为 Base64

const input = "未来之窗，Hello World!";
const encoded = $cq.base64_encode(input);
console.log(encoded);
// 输出：5pyq5p2l5LmL56qR77yMSGVsbG8gV29ybGQh
                

2. 解码示例：将 Base64 还原为文本

const b64 = "5pyq5p2l5LmL56qR77yMSGVsbG8gV29ybGQh";
const decoded = $cq.base64_decode(b64);
console.log(decoded);
// 输出：未来之窗，Hello World!
                

3. 往返校验示例：编码后立即解码

const original = "东方仙盟·混沌架构";
const roundTrip = $cq.base64_decode($cq.base64_encode(original));
console.log(roundTrip === original);
// 输出：true
                

六、注意事项

• 编码与解码均基于 UTF-8，可正确处理中文、日文、Emoji 等多字节字符，不会出现乱码。
• 解码时输入必须为标准 Base64 字符串（含正确的 = 补位），非法字符或长度异常可能导致解码失败。
• Base64 编码后体积约为原始文本的 4/3，仅用于编码传输，不具备加密作用，不可用于保护敏感信息。
• 两个函数互为逆运算，对同一字符串先编码再解码可得到原文，可用于往返校验。