python 3 移除了对内置类型直接使用 `b'%s' % obj` 的支持，需先生成字符串再编码为 bytes；推荐用 `str(obj).encode('utf-8')` 或 `%a` + ascii 编码实现兼容、安全的字节串格式化。
在 Python 3 中，不存在“为内置类型安装字节串格式化器”这一操作——这不是一个可插拔或可安装的功能，而是语言设计的根本变更。Python 2 中 b'%s' % 15 能直接工作，是因为其 bytes 类型（即 str）同时承载文本和二进制语义；而 Python 3 明确区分 str（Unicode 文本）与 bytes（原始字节），% 操作符对 bytes 左操作数（如 b'%s'）严格要求右操作数必须是 bytes 或实现 __bytes__() 的对象。但绝大多数内置类型（如 int、None、list）并未实现 __bytes__()，因为它们本质上是文本/数据容器，而非字节序列。
因此，正确且惯用的做法是：先用字符串格式化生成 Unicode 表示，再显式编码为 bytes。以下是几种推荐方案：
✅ 推荐方式：str(obj).encode('utf-8')
>>> str(None).encode('utf-8')
b'None'
>>> str(15).encode('utf-8')
b'15'
>>> str([1, 'hello']).encode('utf-8')
b"[1, 'hello']"- 优点：语义清晰、兼容所有内置类型、支持任意 Unicode 内容；
- 注意：若需网络传输或协议兼容，UTF-8 是最通用选择；避免硬编码 'ascii'，除非你确定内容绝对无非 ASCII 字符。
⚠️ 谨慎使用：('%s' % obj).encode('ascii')
>>> ('%s' % {'name': 'café'}).encode('ascii')
# UnicodeEncodeError: 'ascii' codec can't encode character '\xe9'...ASCII 编码仅适用于纯 ASCII 字符串，一旦对象 __str__() 返回含非 ASCII 字符（如重音符号、emoji、中文），将立即抛出异常。不建议在不确定数据来源时使用。
? 安全转义：('%a' % obj).encode('ascii')
>>> ('%a' % ['café', '∀', '?']).encode('ascii')
b"['caf\\xe9', '\\u2200', '\\U0001f44d']"%a 等价于 repr()，自动对非 ASCII 字符转义为 \xHH、\uXXXX 或 \UXXXXXXXX 形式，确保结果 100% ASCII 可编码。适合调试日志、Python 字节协议序列化等需“可逆文本表示”的场景。
立即学习“Python免费学习笔记（深入）”；
❌ 不可行方案（避免尝试）
- 试图给 int、list 等内置类型动态添加 __bytes__() 方法（违反不可变内置类型原则，且 __bytes__ 应返回有意义的二进制表示，而非字符串编码）；
- 使用 codecs.encode(str(obj), 'utf-8') —— 功能等价但冗余，str.encode() 更直接；
- 强制 bytes(str(obj), 'utf-8') —— 语法正确但不如 .encode() 显式和惯用。
总结
| 场景 | 推荐方法 | 说明 |
|---|---|---|
| 通用协议/网络传输 | str(obj).encode('utf-8') | 最灵活、最标准 |
| 需 ASCII 兼容且容忍转义 | ('%a' % obj).encode('ascii') | 安全、可预测、适合日志或元数据 |
| 确保纯 ASCII 输入 | str(obj).encode('ascii') | 仅限可信数据源，否则加 errors='replace' 或 errors='ignore' 处理异常 |
迁移 Python 2 协议代码时，请将所有 b'%s' % x 替换为 str(x).encode('utf-8')，并测试非 ASCII 数据路径——这才是 Python 3 文本/字节分离哲学下的正确实践。
