上传文件
  1. base64hub
  2. 文档

base64hub 文档

base64hub 在网站之外提供的所有产品的参考文档。每个产品都遵循相同的 Base64 规则,所以在一个页面上学到的内容同样适用于其他页面。

选择产品

你想要使用文档
在终端或脚本中编码或解码b64 CLICLI
在 Node.js 中调用 Base64 函数npm 上的 base64hubnpm 包
在 Python 中调用 Base64 函数PyPI 上的 base64hubPython 包
为 AI 助手提供精确的 Base64 工具base64hub-mcpMCP 服务器
不打开标签页,直接在 Chrome 中编码或解码浏览器扩展Chrome 扩展
从任何语言或无代码工具发起 HTTP 请求https://api.base64hub.com/v1HTTP API
在手机上编码或解码@base64hubbotTelegram 机器人

它们全部免费,都采用 MIT 许可证,也都没有运行时依赖。安装命令和下载见 下载页面。

共同规则

这些产品共用一份规范和一套测试向量,所以结果逐字节一致。

编码 使用 RFC 4648 中的标准字母表并带 = 填充,除非你要求使用 URL 安全字母表(- 和 _)或不带填充。换行会在每 N 个字符后插入一个 \n,但结尾不加;76 是 MIME 的行长。data URI 从不换行;如果没有指定 MIME 类型,就根据内容检测:PNG、JPEG、GIF、WebP、PDF 和 SVG 按文件签名识别,UTF-8 文本识别为 text/plain;charset=utf-8,其他则为 application/octet-stream。

解码 有意设计得宽松:

  1. 去掉首尾的空白,并移除 data:...;base64, 前缀。
  2. 忽略文本中的空格、制表符、CR 和 LF。
  3. 末尾的 = 填充可有可无。超过两个 =,或者 = 出现在其他任何位置,都是错误。
  4. 两种字母表都接受,即使在同一个字符串中混用也可以。
  5. 其他任何字符都是错误;长度导致最后一个四字符组只剩一个字符,也是错误。
  6. 空输入解码为空输出。

错误按从左到右的顺序报告,位置在清理后的输入中从 0 开始计数。CLI 和 API 的措辞如下:

invalid character '!' at position 4
unexpected '=' at position 2: padding is only allowed at the end
too much padding: 3 '=' at position 2, at most 2 are allowed
invalid length: 5 characters leave a single character in the last group

校验 恰好在解码能成功时通过。它还会报告 variant(出现 + 或 / 为 standard,出现 - 或 _ 为 url,两者都有为 mixed,都没有为 either)、输入是否已 padded 到 4 的倍数,以及解码后的大小 bytes。

在只能显示文本的地方,例如 API 的 JSON、MCP 的结果和机器人,不是有效 UTF-8 的解码字节会以十六进制给出,而不是显示成乱码。

网站本身

base64hub.com 上的工具在你的浏览器中运行,从不调用 API:内容安全策略会拦截除匿名页面浏览计数以外的所有请求。这些文档中的代码示例供你复制使用;这些页面上没有任何内容会向 API 发送请求。

更新于 2026年11月22日