上传文件
  1. base64hub
  2. 文档
  3. CLI

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
npmnpm i -g base64hub
pipxpipx install base64hub
Gogo 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日