Python %字符串格式化怎么控制宽度、精度和对齐？

键盘旁的猫

发布时间：2026-10-24| 5人浏览过

原创

在 Python 中，通过 % 运算符控制输出格式时，核心是在 % 与类型字符之间插入 [flags][width][.precision] 规则：其中 width 定义输出的最小字符宽度，默认右对齐并填充空格；添加 - 标志可切换为左对齐，添加 0 标志则以数字零进行前置补位；小数点后的 .precision 对浮点数表示保留的小数位数，对字符串则表示最大截取长度。

一、格式化占位符的语法结构

Python 的 % 格式化语法脱胎于 C 语言的 printf 风格。完整的占位符由引导符、标志位、最小字段宽度、小数点及精度值、转换类型等五个要素组成。

Python %字符串格式化怎么控制宽度、精度和对齐？ — 图 1: % 格式化表达式各组成要素及其位置关系

各组成部分的作用分工如下：

flags（可选）：控制对齐方向和空白填充。常见的有 -（强制左对齐）、0（数字左侧补零填充）、+（正数显示正号）、空格（正数保留空格位）。
width（可选）：指定输出的最少字符总数。如果格式化结果本身长度小于该值，则会补充填充符；如果本身长度已超出该值，原样输出，不会被强制裁切。
.precision（可选）：由点号 . 和数字组成。对于浮点数，它控制小数部分的保留位数并执行四舍五入；对于字符串，它控制最大显示字符数并截断超出部分。
type（必选）：决定如何解释传入的对象，如 %d 对应整数、%f 对应浮点数、%s 对应字符串。

二、格式化求值与处理步骤

当 Python 解释器执行格式化表达式时，并不是一次性完成替换的，而是按照固定的次序依次评估类型转换、精度裁切、字段宽度与对齐方式。

理解这个流程的关键在于：精度裁剪优先于宽度填充生效。例如格式化一个超长字符串并指定了宽度，系统首先根据精度把它截断，然后再依据宽度决定是否补充空格，两者各司其职，互不冲突。

三、控制字段宽度与对齐方式

字段宽度（width）用来保证输出结果占据至少若干个字符位，常用于终端对齐列数据或规整报表格式。

1. 默认右对齐与空格填充

直接在 % 与类型符之间写一个整数，即表示最小宽度。默认情况下，内容靠右放置，左侧多余位置用空格填充：

# 示例代码：默认右对齐
score_a = 95
score_b = 7
print("|%5d|" % score_a)
print("|%5d|" % score_b)

终端输出示例

|   95|
|    7|

2. 使用 - 标志实现左对齐

在宽度前加上减号 -，内容将紧贴左侧显示，多余的占位空格被放置在右侧：

# 示例代码：左对齐
name = "Alice"
print("|%-10s|" % name)
print("|%-10d|" % 123)

终端输出示例

|Alice     |
|123       |

3. 使用 0 标志实现零填充（常用于编号与时间）

在宽度前加 0，数字左侧空余位置会被填充为 0，常用于序号或固定位数生成。注意，零填充只能与数字类型配合使用；若同时指定 -（左对齐），由于左对齐右边补零会篡改数值大小，0 标志将被忽略。

# 示例代码：前补零
user_id = 42
print("用户编号: %06d" % user_id)

终端输出示例

用户编号: 000042

四、控制精度：浮点数舍入与字符串截断

精度（.precision）以点号开头，但对不同类型的数据有着截然不同的语义。

1. 浮点数的小数位数控制

对于 %f、%e，精度表示小数点后保留的位数。系统会在该精度处执行舍入（四舍五入到最近的偶数），不足位数补零：

# 示例代码：浮点数保留小数
pi = 3.14159265
print("%.2f" % pi)
print("%.4f" % pi)
print("%.0f" % pi)

终端输出示例

3.14
3.1416
3

如果不显式指定精度，%f 默认的精度值为 6，即默认输出 6 位小数。

2. 字符串的最大长度截断

当精度应用于 %s 字符串时，它表示最大显示长度。超过该长度的字符会被直接丢弃，常用于防止超长标题破坏表格排版：

# 示例代码：字符串截断
title = "PythonProgramming"
print("%.6s" % title)

终端输出示例

Python

3. 宽度与精度的协同应用

将宽度和精度组合时，精度先行计算出字符串，然后整体参与宽度占位：

# 示例代码：组合使用
price = 12.5
# 宽8位，保留2位小数，右对齐
print("[%8.2f]" % price)
# 宽8位，保留2位小数，左对齐
print("[%-8.2f]" % price)

终端输出示例

[   12.50]
[12.50   ]

五、动态参数控制：使用星号 *

在实际工程中，宽度或精度往往不是硬编码的常量，而是由终端尺寸或用户配置决定的变量。这时可以使用星号 * 作为占位符，由元组中的额外参数在运行时传入：

# 示例代码：使用 * 动态指定宽度与精度
dynamic_width = 10
dynamic_prec = 3
val = 4.56789

# 元组中依次传入：宽度、精度、目标数值
formatted = "%*.*f" % (dynamic_width, dynamic_prec, val)
print("[%s]" % formatted)

终端输出示例

[     4.568]

六、常用组合与参数速查矩阵

为了便于在编码时快速查阅，以下总结了最典型的格式化场景与对应的语法公式：

七、关键注意事项与陷阱规避

1. 单元素元组逗号陷阱
当向 % 右侧传递多个变量时必须使用元组 (a, b)。但如果传递的是单个元组本身，Python 会尝试将其展开匹配占位符，若要原样把元组打印出来，必须包一层外层元组 % (my_tuple,)。

2. 字典键值映射格式化
% 语法还支持基于字典键名的格式控制，语法为 %(key)[flags][width][.precision]type。例如：
"%(name)-10s: %(score)05.2f" % {"name": "Bob", "score": 8.5}
这在需要处理字段名明确、无序传入的复杂数据结构时能有效防止按位置传参引发的错位。

3. 转义百分号本身
如果模板字符串中本身需要显示 % 字符（例如打印折扣率或完成度），需要使用双百分号 %% 进行转义，如 "完成率: %d%%" % 85 输出为 完成率: 85%。

虽然现代 Python 推荐在日常业务开发中使用更加直观的 f-string（f"{val:10.2f}"），但理解 % 格式化中的宽度、精度和对齐机制，不仅能帮助维护大量既有历史代码、在标准库 logging 模块中高效编写日志模板，更能掌握经典格式化规范的底层共性逻辑。