b64 CLI 参考
b64 编码、解码和校验 Base64。本页列出每个参数、参数的组合规则,以及命令会输出和返回什么。
安装
| 方式 | 命令 |
|---|---|
| Homebrew(macOS、Linux) | brew install base64hub-com/tap/b64 |
| Scoop(Windows) | scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap,然后 scoop install b64 |
| winget(Windows) | winget install base64hub.b64 |
| AUR(Arch Linux) | yay -S b64-bin |
| 安装脚本 | curl -fsSL https://base64hub.com/install.sh | sh |
| npm | npm i -g base64hub |
| pipx | pipx install base64hub |
| Go | go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest |
适用于 x86_64 和 arm64 的 macOS、Linux 和 Windows 发行归档、.deb 包以及 SHA256SUMS 文件都在 下载页面。用 b64 --version 检查安装,它会输出 b64 1.0.0。
npm 和 pipx 版本是同一个命令,参数和消息都相同。唯一的区别:Go 版本分块流式读取标准输入,而 npm 和 Python 版本会先把全部输入读入内存。
用法
b64 [flags] [TEXT]
带 TEXT 时,b64 处理 TEXT 的 UTF-8 字节,不会添加换行符。不带 TEXT 时,它读取标准输入直到结束,或者读取 -i 指定的文件。参数可以放在 TEXT 之前,也可以放在之后。
编码时输出 Base64 并加一个换行符。解码时只写出原始字节,不加其他任何内容,所以 b64 -d 的输出可以是二进制文件。
参数
| 参数 | 含义 |
|---|---|
-d, --decode | 把 Base64 解码为原始字节。 |
-u, --url | 用 URL 安全字母表(- 和 _)编码。 |
-n, --no-pad | 编码时不加 = 填充。 |
-w N, --wrap N | 编码输出每 N 个字符换行;0(默认)表示不换行,76 对应 MIME。 |
--data-uri | 编码为 data: URI;MIME 类型根据内容检测。 |
-m TYPE, --mime TYPE | --data-uri 使用的 MIME 类型。 |
--validate | 检查输入,报告其变体和解码后的大小。 |
-i FILE, --input FILE | 读取 FILE 而不是标准输入;- 表示标准输入。 |
-o FILE, --output FILE | 写入 FILE 而不是标准输出;- 表示标准输出。 |
-h, --help | 显示帮助。 |
-v, --version | 输出 b64 和版本号。 |
-- | 参数到此结束:下一个参数即使以 - 开头,也视为 TEXT。 |
参数的组合规则
- 短参数不能合并:
-dn是未知选项。值写在空格之后(-w 4),长参数也可以写在=之后(--wrap=4);不接受-w4。 -u、-n、-w和--data-uri只适用于编码;与-d或--validate一起使用属于用法错误。-d和--validate不能同时使用。--data-uri始终使用带填充的标准字母表并输出为一行,所以不能与-u、-n和-w同时使用。--mime必须配合--data-uri使用。- TEXT 和
-i不能同时使用,而且只允许一个 TEXT:包含空格的文本要加引号。 - 以
-开头的 TEXT,例如 URL 安全的 Base64,前面要加--:b64 -d -- -_-_。
退出码和消息
| 代码 | 含义 |
|---|---|
0 | 成功。 |
1 | 输入无效,或者文件无法读取或写入。 |
2 | 用法错误:未知参数、错误的值,或者不能同时使用的参数。 |
错误以 b64: <message> 的形式输出到标准错误。对于有效输入,--validate 向标准输出打印 valid (<variant>, <bytes> bytes);否则向标准错误打印 invalid: <reason>,退出码为 1。
$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4
$ b64 -d 'Zm=9v'
b64: unexpected '=' at position 2: padding is only allowed at the end
$ b64 -d 'Zg==='
b64: too much padding: 3 '=' at position 2, at most 2 are allowed
$ b64 -d 'Zm9vY'
b64: invalid length: 5 characters leave a single character in the last group
$ b64 -d -u Zm9v
b64: --url only applies to encoding, not to --decode
位置在去掉空格、制表符和换行后的输入中从 0 开始计数。
示例
编码和解码文本:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
URL 安全,带填充和不带填充:
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
$ b64 -n f
Zg
换行;另外注意 echo 会加一个换行符,它也会被编码:
$ b64 -w 4 foobar
Zm9v
YmFy
$ echo hello | b64
aGVsbG8K
data URI,自动检测或显式指定类型:
$ b64 --data-uri Hello
data:text/plain;charset=utf-8;base64,SGVsbG8=
$ b64 --data-uri -m text/csv 'a,b'
data:text/csv;base64,YSxi
$ b64 --data-uri -i logo.png -o logo.txt
解码很宽松:换行、data: 前缀和缺失的填充都接受,以 - 开头的字符串要放在 -- 之后:
$ b64 -d 'data:text/plain;base64,SGk='
Hi
$ b64 -d -- -_-_ | xxd -p
fbffbf
在脚本中校验:
$ b64 --validate SGVsbG8sIGh1YiE=
valid (either, 11 bytes)
$ b64 --validate 'a+b_'
valid (mixed, 3 bytes)
if b64 --validate -i token.txt >/dev/null 2>&1; then
echo "token looks like Base64"
else
echo "token is broken" >&2
fi
文件输入和输出:
b64 -i photo.jpg -o photo.b64
b64 -d -i photo.b64 -o photo-copy.jpg
自动检测的 MIME 类型
不带 --mime 的 --data-uri 会查看开头的字节:PNG、JPEG、GIF、WebP 和 PDF 按文件签名识别;文本以 <svg 开头,或者以 <?xml 开头并包含 <svg 时,识别为 SVG。其他不含控制字符的有效 UTF-8 文本(制表符、CR 和 LF 不算控制字符)识别为 text/plain;charset=utf-8;其余一律为 application/octet-stream。
更新于 2026年11月22日