Python中%()是旧式字符串格式化方法，通过占位符将变量插入字符串，虽然语法简洁但在Python 3中已非首选，推荐使用format()或f-string。
百分号格式化的基础用法
%()格式化由两部分组成：左侧模板字符串中的占位符，右侧括号内的实际值（元组或字典），这种模式在Python 2时代是主流，至今仍能在大量遗留代码中见到。
常用占位符类别
- %s：字符串占位符，接受任何对象（自动调用
str()） - %d：整数占位符，接受整数或可转换为整数的对象
- %f：浮点数占位符，默认保留6位小数
- %x：十六进制整数占位符
- 转义表示一个百分号
操作示例：
name = "Tom"
age = 25
print("My name is %s, I'm %d." % (name, age))
指定宽度与精度
在占位符中插入数字可控制格式：
- %10s：右对齐，最小宽度10个字符
- %<10s：左对齐
- %.2f：保留两位小数
- %08d：用0填充至8位宽度
price = 12.3456
print("Price: %.2f" % price) # 输出 Price: 12.35
使用字典进行格式化
当变量较多时,可以用字典代替元组，代码更清晰：
info = {"name": "Alice", "score": 92}
print("Name: %(name)s, Score: %(score)d" % info)
这种方式在模板字符串中直接引用字段名,避免了顺序错误。
python 字符串格式化方法对比
%()并非唯一的格式化方式，Python 3引入了str.format()，Python 3.6之后又增加了f-string，三者各有适用场景。
语法可读性
| 方法 | 典型写法 | 可读性 |
|---|---|---|
| %格式化 | "Hello %s, age %d" % (name, age) |
中等，需注意顺序 |
| format() | "Hello {}, age {}".format(name, age) |
较好，支持隐式引用 |
| f-string | f"Hello {name}, age {age}" |
★最佳，直接嵌入变量 |
性能表现
在Python 3.8+的测试中，f-string通常是速度最快的，格式化略慢于format()，但差距微乎其微，对于短次数格式化，三者的性能差异可以忽略，只有在循环中重复执行大量格式化操作时，才需要考虑优先使用f-string。
功能灵活性
- %格式化：功能最基础，不支持复杂表达式或属性访问
- format()：支持格式化规范、对象属性、索引、对齐等高级功能
- f-string：支持任意Python表达式，调用函数、计算均可在花括号内完成
兼容性要求
- 需要兼容Python 2.6及更早版本时，只能使用%格式化
- 需要兼容Python 3.0-3.5时，可使用%格式化或format()
- 仅面向Python 3.6+时，推荐优先使用f-string
python %s 和 %d 区别
%s和%d是最常见的两个占位符，正确理解它们的区别能避免类型错误。
类型自动转换
- %s：调用
str()
将对象转为字符串，任何对象都能用
- %d：要求对象为整数，否则会抛出
TypeError（浮点数也不行，但可通过int()转换）
value = 3.14print("%s" % value) # 输出 "3.14"print("%d" % value) # 报错：%d format: a real number is required, not float使用场景
- 当你需要输出用户友好的字符串内容时,多用%s
- 当你需要保证输出是整数、且希望格式化宽度或填充时，用%d
- 对于数字但不想严格限制为整数,可用%f或%s
混合使用时的注意事项
在同一个模板中混合使用%s和%d时，右侧元组的值必须顺序对应，如果类型不匹配，Python会立即报错，不会自动转换，这有助于提前发现数据问题。
实际应用场景：日志与遗留代码
尽管f-string推荐度越来越高，但%()在某些场景下仍是必须或首选。
日志记录（logging模块）
Python的logging模块底层使用%格式化来延迟构建日志消息，这是官方设计的选择，例如logging.debug("User %s logged in", user)，其中的占位符在日志级别未达到时不会真正格式化，从而提升性能，在这个场景下，%()是与日志系统深度绑定的，无法被f-string直接替代。
兼容旧代码与多语言项目
在维护Python 2/3共存项目或大型遗留系统时，%格式化代码随处可见，直接全面替换为f-string成本高、风险大，因此了解%()的细节仍是必备技能。
与数据库查询的界限
需要明确：%()不应用于拼接SQL查询，使用cursor.execute("SELECT FROM users WHERE name = %s", (name,))
时，这里的%s是数据库驱动（如MySQLdb）的占位符，与Python的字符串%格式化无关，混淆两者可能导致SQL注入风险。
性能与最佳实践
三种格式化方式的速度差异
在Python 3.10中，对简单字符串格式化进行100万次循环测试：
- f-string：约0.12秒
- %格式化：约0.18秒
- format()：约0.15秒
%格式化在后来的版本中已经优化，不再是性能瓶颈，但在极高端多次循环场景下，仍建议优先使用f-string。
何时坚持使用%()
- 代码需要兼容Python 2.6及以下
- 使用logging模块的延迟格式化
- 维护大型遗留代码库,统一风格以降低修改量
- 动态生成格式化模板（例如从配置文件读取）
何时迁移到新写法
- 新项目直接使用f-string（Python 3.6+）
- 需要复杂格式化规范（如对齐、千分位）时用format()
- 追求代码简洁和可读性
python中%()常见问题解答
Q1: %()格式化中如何转义百分号本身？
使用两个连续的百分号来表示一个文字百分号,例如"Progress: %d%%" % 80输出”Progress: 80%”。
Q2: 为什么我的%d格式化浮点数时报错？
%d要求传入整数，若传入浮点数会抛TypeError，需要先转换为整数：int(3.14)，或改用%f（保留小数）或%.0f（舍入为整数字符串）。
Q3: 使用字典格式化时，模板中的键名必须与字典的键完全一致，否则会抛出KeyError，建议使用collections.defaultdict或设置默认值来避免缺失键错误。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/509987.html
