b64 能做什么
b64 把字节转换成 Base64 文本,也能反向转换。可以把文本作为参数传给它,用管道把数据传给它,或者用 -i 指定一个文件。编码时输出结果并加一个换行符;解码时只写出原始字节,不加任何其他内容,所以二进制文件能完整还原。
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
最后两条命令展示了 URL 安全字母表(用 - 和 _ 代替 + 和 /)以及不带 = 填充的输出,JWT 和 URL 用的就是这种形式。两者的区别见 Base64 与 Base64URL。
安装
上方的安装框列出了每种包管理器的命令。简单来说:
| 平台 | 命令 |
|---|---|
| macOS、Linux(Homebrew) | brew install base64hub-com/tap/b64 |
| Windows(winget) | winget install base64hub.b64 |
| Windows(Scoop) | scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap,然后 scoop install b64 |
| Arch Linux(AUR) | yay -S b64-bin |
| 任意 Unix shell | curl -fsSL https://base64hub.com/install.sh | sh |
| 已装有 Node.js 或 Python | npm i -g base64hub 或 pipx install base64hub |
| 已装有 Go | go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest |
如果想直接下载,全部下载 提供适用于 x86_64 和 arm64 的 .tar.gz、.zip 和 .deb 构建,并附有用于校验的 SHA256SUMS 文件。npm 和 PyPI 版本安装的是同一个 b64 命令,参数也相同。
日常示例
注意换行符:echo 会自动加一个,而 b64 会编码收到的每一个字节。
$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=
用 -w 让较长的输出换行,例如按 MIME 的要求每 76 个字符一行:
$ printf 'foobar' | b64 -w 4
Zm9v
YmFy
生成 data URI。MIME 类型根据内容检测(PNG、JPEG、GIF、WebP、PDF、SVG、文本),也可以用 -m 指定:
$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt
使用一个字符串之前,先检查它。无效输入的检查结论输出到 stderr,退出码为 1。以 - 开头的字符串前面要加 --,以免被当成参数:
$ b64 --validate -- -_-_
valid (url, 3 bytes)
$ b64 --validate 'Zm9vY'
invalid: invalid length: 5 characters leave a single character in the last group
$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4
b64 与 base64 命令对比
Linux 自带 GNU coreutils 中的 base64,macOS 自带 BSD 版本,两者的参数不同(详见 Bash 中的 Base64)。b64 在每个系统上的表现都一样。下表中 GNU 一列已用 coreutils 9.7 验证。
| 任务 | GNU base64 | b64 |
|---|---|---|
| 输出行长 | 每 76 个字符换行,除非 -w 0 | 单行,除非 -w N |
| URL 安全字母表 | 不支持(basenc --base64url 可以) | -u / --url |
解码含 - 或 _ 的输入 | base64: invalid input | 接受 |
data: URI 输入或输出 | 不支持 | --data-uri;解码时自动去掉前缀 |
| 检查字符串 | 不支持 | --validate,显示变体和字节数 |
| 错误详情 | invalid input | 有问题的字符及其位置 |
b64 的解码有意设计得宽松:空格、制表符和换行会被忽略,填充可有可无,两种字母表都接受。除此之外的情况,例如多出来的 ! 或中间出现的 =,都是错误,退出码为 1。用法错误的退出码为 2,所以脚本能区分是数据有误还是命令行写错了。
离线工作
b64 在你的电脑上完成全部工作,不需要账号,也不需要网络连接。Go 版本分块流式读取标准输入,处理几 GB 的输入时内存占用依然平稳。在浏览器中处理零散的字符串,可以用本站的 Base64 编码器 和 解码器;CLI 文档 介绍了每个参数和退出码。
常见问题
怎样用 Homebrew 安装 Base64 命令行工具?
运行 brew install base64hub-com/tap/b64。formula 位于 base64hub-com/tap 这个 tap 中,会在 macOS 和 Linux 上安装 b64 命令。
b64 能直接替代 base64 命令吗?
不能,两者的参数不同。b64 只有在传入 -w 时才换行,在所有系统上都用 -d 解码,还增加了 URL 安全输出、data URI 和校验功能。依赖 base64 确切行为的脚本,请继续使用 base64。
怎样在命令行中把文件编码为 Base64?
b64 -i photo.jpg -o photo.b64,或者 b64 < photo.jpg > photo.b64。加上 --data-uri 可以得到 data:image/jpeg;base64,… 字符串,直接粘贴到 HTML 或 CSS 中。
为什么 b64 输出“valid (either, …)”?
这个字符串不含 + / - _ 中的任何一个,所以在标准字母表和 URL 安全字母表中都有效。出现这些字符时,会显示 standard、url 或 mixed。