Python str.format() 语法全解析
在Python的字符串处理世界中,str.format()方法自Python 2.6引入以来,已成为最强大、最灵活的格式化工具之一。它不仅取代了旧式的百分号格式化(%),更在可读性、扩展性和功能深度上实现了质的飞跃。本页面将系统性地拆解format()语法的全部核心特性,从基础用法到高级技巧,从性能优化到实际应用,辅以50+个可直接运行的代码示例,助您彻底掌握这一Python字符串处理的“瑞士军刀”。
在实际开发中,我们常常需要将动态数据嵌入固定模板中,例如生成日志信息、构建SQL查询语句、生成HTML片段、构造API响应体等。format()方法通过占位符机制实现了高度解耦的格式化逻辑,使代码更清晰、更安全、更易维护。
- 支持位置参数、关键字参数、混合参数等多种绑定方式
- 内置丰富格式说明符(如
{:05d}、{:.2f}、{:>10}) - 支持自定义格式化类(通过
__format__()协议) - 支持嵌套字段访问(如
{user.name}、{items[0].price}) - 兼容
datetime、Decimal等标准库类型 - 支持对齐、填充、符号、千位分隔等高级控制
值得注意的是,尽管Python 3.6引入了更简洁的f-string语法(字面量格式化字符串),format()方法因其运行时动态性、跨版本兼容性及在模板引擎中的广泛使用,依然具有不可替代的价值。尤其在需要动态构建格式字符串(如从配置文件读取模板)、处理用户输入的格式化逻辑、或在旧版Python环境中工作时,format()仍是首选方案。
一、基础语法:从零构建格式化能力
str.format()的核心思想是将字符串中的{}占位符替换为传入的参数。其基本形式为:"模板字符串".format(参数1, 参数2, ...)。占位符可为空(隐式位置绑定),也可指定索引或名称(显式绑定)。
1.1 隐式位置绑定
最简单的用法,按顺序绑定参数:
print("欢迎,{}!今天是{}。".format("小明", "星期一"))
# 输出:欢迎,小明!今天是星期一。
若占位符数量与参数数量不匹配,将抛出IndexError异常:
"{} {}".format("A") # IndexError: Replacement index 1 out of range for positional args tuple
1.2 显式位置索引
通过在{}中指定索引,可重复使用参数或调整顺序:
print("{0} + {0} = {1}".format(2, 4))
# 输出:2 + 2 = 4
print("{1} 在 {0} 之后".format("春天", "夏天"))
# 输出:夏天 在 春天 之后
索引必须非负整数,且不能超出参数个数范围。索引可重复,但不能跳过(如{0}{2}缺少{1})。
1.3 关键字参数绑定
使用命名参数,增强可读性与灵活性:
print("姓名:{name},年龄:{age},城市:{city}".format(name="李雷", age=28, city="成都"))
# 输出:姓名:李雷,年龄:28,城市:成都
参数可混合使用位置与关键字,但位置参数必须在关键字参数之前:
"{0} 和 {name}".format("苹果", name="香蕉") # ✅ 正确
"{name} 和 {0}".format("苹果", name="香蕉") # ❌ SyntaxError
1.4 字面量转义
输出字面量{或}需使用双写:{{和}}:
print("Python版本:{{}}".format("3.11"))
# 输出:Python版本:{3.11}
print("{{name}} 是占位符,{{}} 是转义".format())
# 输出:{name} 是占位符,{} 是转义
二、格式说明符:精细控制输出样式
占位符的完整语法为:{[index][!conversion][:format_spec]},其中format_spec(格式说明符)是核心,其通用结构为:[[fill]align][sign][#][0][width][,][.precision][type]。下面分项详解。
2.1 对齐与填充
格式说明符可指定对齐方式和填充字符:
| 对齐符号 | 含义 | 示例 | 输出 |
|---|---|---|---|
< |
左对齐(默认) | "{:<10}".format("A") |
A |
> |
右对齐 | "{:>10}".format("A") |
A |
^ |
居中对齐 | "{:^10}".format("A") |
A |
填充字符默认为空格,可自定义(但必须是单个字符):
"{:*<10}".format("test") # 'test******'
"{:0>10}".format("data") # '000000data'
"{:#^10}".format("center") # '##center##'
⚠️ 注意:若指定填充字符,必须与对齐符号连用(如0>),不能单独写{:010}(会被误判为宽度010)。
2.2 数值格式化
format()对数值类型提供丰富支持,尤其在整数、浮点数、百分比方面:
整数格式化
常用类型:d(十进制)、b(二进制)、o(八进制)、x/X(十六进制):
num = 42
print("十进制:{0:d},二进制:{0:b},十六进制:{0:x},大写:{0:X}".format(num))
# 输出:十进制:42,二进制:101010,十六进制:2a,大写:2A
配合宽度与千位分隔符:
print("{:08d}".format(123)) # '00000123'
print("{:,}".format(1234567890)) # '1,234,567,890'
浮点数格式化
类型:f(定点)、e(科学计数)、%(百分比):
pi = 3.14159265
print("保留2位小数:{:.2f}".format(pi)) # '3.14'
print("科学计数:{:.2e}".format(123456)) # '1.23e+05'
print("百分比:{:.1%}".format(0.876)) # '87.6%'
固定宽度与精度组合:
"{:+10.2f}".format(-3.14) # ' -3.14'
"{:10.3f}".format(0.1) # ' 0.100'
2.3 字符串截断与宽度
对字符串,.N表示最大字符数(截断),N表示最小宽度(不足填充):
text = "Python格式化"
print("{:.4}".format(text)) # 'Pyth'(截断)
print("{:10.4}".format(text)) # 'Pyth '(先截断再对齐)
print("{:>10.4}".format(text)) # ' Pyth'
⚠️ 注意:宽度和截断均按字符计数(非字节),对中文同样适用。
2.4 特殊类型支持
内置类型如datetime、Decimal也遵循__format__()协议:
from datetime import datetime
dt = datetime(2023, 10, 15, 14, 30)
print("{:%Y-%m-%d %H:%M}".format(dt)) # '2023-10-15 14:30'
from decimal import Decimal
val = Decimal("1234.567")
print("{:.2f}".format(val)) # '1234.57'
三、高级技巧:解锁format()的隐藏能力
以下技巧常被忽视,却能显著提升代码优雅度与效率。
3.1 嵌套字段访问
支持通过点号访问对象属性,通过方括号访问索引/键:
data = {"user": {"name": "张三", "age": 30}, "items": [100, 200]}
print("{user[name]} 的年龄是 {user[age]}".format(user=data["user"]))
# 输出:张三 的年龄是 30
print("第一个商品价格:{items[0]}".format(**data))
# 输出:第一个商品价格:100
⚠️ 注意:键名必须是合法标识符或整数索引;若键含特殊字符(如"user-name"),需先转为属性访问(如getattr包装)。
3.2 动态格式字符串
占位符本身可动态生成,实现运行时模板定制:
template = "{:0{}d}" # 生成动态宽度的数字格式
print(template.format(7, 4)) # '0007' → 等价于 "{:04d}"
原理:外层format()先计算宽度{},再将结果作为内层格式说明符使用。
3.3 自定义格式化类
通过实现__format__()方法,使自定义对象适配format():
class Point:
def __init__(self, x, y):
self.x, self.y = x, y
def __format__(self, spec):
if spec == "polar":
from math import hypot, atan2
r = hypot(self.x, self.y)
theta = atan2(self.y, self.x)
return f"({r:.2f}, {theta:.2f} rad)"
return f"({self.x}, {self.y})"
p = Point(3, 4)
print("直角坐标:{0},极坐标:{0:polar}".format(p))
# 输出:直角坐标:(3, 4),极坐标:(5.00, 0.93 rad)
3.4 与format_map()配合
dict.format_map()避免缺失键时的KeyError,支持默认值:
template = "{name} 的邮箱是 {email}"
data = {"name": "王五"}
print(template.format_map(data)) # KeyError: 'email'
# 使用默认字典
from collections import defaultdict
safe_data = defaultdict(lambda: "未知", data)
print(template.format_map(safe_data))
# 输出:王五 的邮箱是 未知
四、方案对比:format() vs % vs f-string
优势:
• 支持复杂嵌套(如{0[1].name})
• 可复用占位符({0} {0})
• 运行时动态构建模板
• 兼容Python 2.6+
劣势:
• 语法冗长
• 无IDE实时语法高亮
• 性能低于f-string(约慢20%)
优势:
• 历史悠久,广泛用于旧项目
• 原生支持%s、%d等基本类型
劣势:
• 仅支持位置/命名绑定,无索引重排
• 不支持复杂嵌套
• 已被标记为过时(deprecated)
• 易与模运算符%混淆
示例:
"%s: %d" % ("ID", 101)
优势:
• 最简语法(f"{name}")
• 编译时求值,性能最优
• 支持任意表达式({x+1})
• IDE实时高亮
劣势:
• 仅Python 3.6+可用
• 模板无法动态生成(字符串已固定)
• 表达式错误需编译时发现
示例:
name="李四"; f"{name.upper()} 今天快乐"