文档章节

编码函数

用这些函数对数据做编码与解码。

这一章解决「文本要进出非文本环境」的问题:把内容塞进 URL、JSON、data: URI 用 base64;需要在 0-9a-f 字符集里表示字节用十六进制;把模板里的数据交给前端 JavaScript 用 JSON。

两个容易混淆的点先说:编码不是加密(base64/hex 谁都能解回来),以及解码函数对输入格式很挑(缺补齐的 =、URL 安全字符、奇数长度的十六进制都会直接让构建失败)。

读完本章你应该能够

  • 在 base64、十六进制、JSON 之间按用途选对函数,并知道三者的体积开销(base64 约 +33%,十六进制翻倍);
  • 说清 base64Decode 与 encoding.HexDecode 的输入要求,以及它们各自的报错信息;
  • 处理中文:base64 与十六进制都按 UTF-8 字节工作,往返无损;
  • 用 encoding.Jsonify 输出 JSON,并知道默认会转义 <、>、&、键按字节序排序、返回类型是 template.HTML;
  • 记住哪些函数有短别名、哪些必须写全名:base64Encode、base64Decode、jsonify 是别名;encoding.HexEncode、encoding.HexDecode 没有别名。

建议阅读顺序

  1. encoding.Jsonify —— 日常最常用:给前端传数据。
  2. encoding.Base64Encode / encoding.Base64Decode —— 成对使用,注意解码对补齐与字符表的要求。
  3. encoding.HexEncode / encoding.HexDecode —— 成对使用,注意必须写全名、输入必须是偶数长度的合法十六进制。

本章内容

  • encoding.Base64Decode 返回给定内容的 base64 解码结果。 (今天)
  • encoding.Base64Encode 返回给定内容的 base64 编码结果。 (今天)
  • encoding.HexDecode 返回给定内容的十六进制解码结果。 (今天)
  • encoding.HexEncode 返回给定内容的十六进制编码结果。 (今天)
  • encoding.Jsonify 返回给定对象编码为 JSON 后的结果。 (今天)