安装
pip install base64hub # the library, in a virtual environment
pipx install base64hub # the b64 command, isolated
只需要 Python 3.9 或更高版本。这个包只使用标准库,安装时不会引入其他任何代码。
编码、解码、校验
四个函数,类型都符合 Python 的习惯:
from base64hub import encode, decode, validate, data_uri
encode("Hello, hub!") # 'SGVsbG8sIGh1YiE='
encode("Привет", url=True, pad=False) # '0J_RgNC40LLQtdGC'
encode(b"foobar", wrap=4) # 'Zm9v\nYmFy'
decode("SGVsbG8sIGh1YiE") # b'Hello, hub!'
decode("data:text/plain;base64,SGk=") # b'Hi'
validate("+/+/")["variant"] # 'standard'
data_uri(b"Hi") # 'data:text/plain;charset=utf-8;base64,SGk='
encode 接受 str(按 UTF-8 编码)或 bytes,返回 str。decode 返回 bytes,遇到不是 Base64 的输入时抛出 base64hub.Base64Error,它是 ValueError 的子类。validate 从不抛出异常:它返回一个包含 valid、variant、padded、bytes 和 error 的字典,输入无效时 error 是原因,否则为 None。
base64hub 与 base64 模块对比
标准的 base64 模块正确而且快。但面对人们粘贴的杂乱输入,它在该宽容的地方很严格,在该报错的地方又很宽松。下面是它在 Python 3.13 上的真实输出:
import base64
base64.b64decode("SGVsbG8sIGh1YiE") # binascii.Error: Incorrect padding
base64.b64decode("Zm9v!YmFy") # b'foobar', the "!" is dropped silently
base64.b64decode("-_-_") # b'', URL-safe characters are dropped
base64 模块 | base64hub | |
|---|---|---|
缺失 = 填充 | Incorrect padding | 接受 |
| URL 安全输入 | 需单独调用 urlsafe_b64decode | decode 直接接受 |
| 无效字符 | 静默丢弃,除非 validate=True | ValueError |
| encode 的返回类型 | bytes | str |
data: URI | 不支持 | data_uri(),解码时自动去掉前缀 |
如果只编码你自己的数据,标准库就够了,用法见 Python 中的 Base64。当输入来自用户、日志、JSON 或 URL,而你希望要么得到正确的结果、要么得到清楚的错误时,再用 base64hub。
b64 命令
pipx install base64hub 会安装与 原生 CLI 相同的 b64 命令:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Python 版本会先把输入读入内存再处理;Go 版本则是流式处理。其他一切,包括参数和退出码,都完全相同。Python 文档 列出了每个函数和参数。
常见问题
怎样用 Python 安装 Base64 命令行工具?
pipx install base64hub 会在独立环境中安装,并把 b64 命令加入 PATH。在虚拟环境中运行 pip install base64hub 也可以。
为什么 base64.b64decode 提示 Incorrect padding?
标准库要求长度是 4 的倍数。base64hub.decode() 会自己补上缺失的 =,所以 decode("SGVsbG8sIGh1YiE") 返回 b'Hello, hub!'。
base64hub 支持哪些 Python 版本?
Python 3.9 及更高版本。除标准库外,这个包没有任何依赖。
不知道是哪种变体时,怎样在 Python 中解码 URL 安全的 Base64?
调用 base64hub.decode():它在同一个字符串中同时接受标准字母表和 URL 安全字母表。用标准库的话,你得自己在 b64decode 和 urlsafe_b64decode 之间做选择。