Python f-string格式化输出变量名及其数据类型

Alice

发布时间：2026-11-05| 3人浏览过

原创

介绍在Python中使用f-string快速格式化输出变量名、变量值及其数据类型的方法，深入解析Python 3.8+自说明表达式语法机制与type().__name__的高效搭配技巧。

在 Python 3.8 及更高版本中，若需要同时格式化输出变量名、变量的值及其数据类型，最简洁高效的写法是在 f-string 中结合自说明调试表达式（=）与 type().__name__ 属性：f"{score=}, type={type(score).__name__}"。对于变量 score = 95，该语句直接输出 score=95, type=int。它既免除了手动重复键入变量名字面量的繁琐，又规避了 type() 默认返回 <class 'int'> 的视觉冗余，是日常调试与日志打点时兼顾开发效率与控制台可读性的标准解法。

Python f-string格式化输出变量名及其数据类型 — 图 0：f-string 变量名与数据类型格式化输出机制全貌

一、为什么推荐自说明表达式与 name 组合？

在日常编写 Python 代码或排查问题时，开发者经常需要在终端或日志中快速核对某个变量的实际运行状态。以往最原始的做法是分别打印变量名与变量值：

# 传统做法：变量名与类型需手动逐个拼接
score = 95
print(f"score={score}, type={type(score)}")
# 示例输出：score=95, type=<class 'int'>

这种传统写法在实际维护中往往面临两个直接痛点：

代码冗余与重命名负担：变量名 score 必须在字符串字面量和表达式花括号中连续写两遍。一旦后续对变量进行重命名，极易遗漏修改引号内的文本，导致控制台输出与实际变量脱节。
类型字符串包含杂质：直接调用 type(score) 返回的是类型对象实例，格式化为字符串后带有 <class '...'> 尖括号包裹，在多变量连续排查时会严重破坏控制台的整洁度。

从 Python 3.8 开始，官方在 f-string 中新增了等号调试语法（PEP 572）。在花括号内的表达式末尾紧跟一个等号 =，Python 解释器会自动截取等号左侧的源码文本，并在其后追加计算结果。再配合类型对象的 __name__ 属性，即可实现极简的单行输出：

# 现代写法：单行内完成自说明与纯净类型提取
score = 95
print(f"{score=}, type={type(score).__name__}")
# 示例输出：score=95, type=int

二、f-string 输出变量名与类型的推导与执行机制

理解该写法的内部运行逻辑，有助于在复杂表达式或自制工具函数中更从容地使用它。当 Python 解释器在编译期扫描到带有等号的 f-string 时，会按以下四个阶段完成推导与渲染：

定义与引用阶段：目标变量（如 score = 95）在当前作用域（全局或局部命名空间）中完成实例化，绑定到内存中的整型对象。
AST 词法解析阶段：解释器解析 f"{score=}" 时，识别到等号位于表达式右侧，自动保留左侧的源码文本 score= 作为字面量前缀，并紧随其后生成对 score 的求值调用（默认使用 repr()）。
类型反射提取阶段：表达式 type(score).__name__ 首先通过内置函数 type() 获取该实例归属的类对象 <class 'int'>，随后访问类对象的魔术属性 __name__，直接提取出无尖括号的短类名 'int'。
字符串拼装交付：将上述两部分求值结果与模板中预设的标点符号无缝拼接，输出整洁直观的调试字符串。

三、两种类型输出方式的对比与结构解析

读者在编写代码时可能会产生疑问：为什么不直接使用 f"{score=}, {type(score)=}"，而要特意提取 __name__ 属性？

虽然 f"{type(score)=}" 语法也是合法的，但它的输出格式是 type(score)=<class 'int'>。这不仅包含长达 12 个字符的函数名包装，还包含了类的元数据标记。以下为两种写法的详细结构对比：

写法方案	典型代码示例	控制台实际输出示例	主要适用场景与评价
推荐做法（自说明 + __name__）	`f"{val=}, type={type(val).__name__}"`	`val=95, type=int`	排版清爽，无冗余文本，最适合单行日志与交互式调试。
自说明全表达式	`f"{val=}, {type(val)=}"`	`val=95, type(val)=<class 'int'>`	虽然省去手动拼写，但字符偏长，多变量并列时容易换行。
传统手动拼接	`f"val={val}, type={type(val)}"`	`val=95, type=<class 'int'>`	Python 3.6/3.7 旧版项目兼容方案，代码重复率较高。

四、空格排版控制与格式说明符的组合实战

在实际工程中，不同团队的代码排版规范可能有所不同。f-string 的自说明语法对空格非常敏感，并支持无缝结合数值格式化说明符。

1. 等号两侧空格的精确保留

f-string 会完整保留花括号内等号两侧书写的空格。如果希望输出更加紧凑，可以不留空格；如果希望符合 PEP 8 赋值风格，可以在等号两侧保留空格：

val = 42

# 紧凑模式：等号无空格
print(f"{val=}, type={type(val).__name__}")
# 示例输出：val=42, type=int

# 宽松模式：等号两侧保留空格
print(f"{val = }, type={type(val).__name__}")
# 示例输出：val = 42, type=int

2. 结合数值精度与格式修饰符

当需要打印浮点数并限定小数位数时，格式化修饰符应当紧跟在等号 = 的后面。例如保留两位小数的百分比或价格输出：

ratio = 0.88421
print(f"{ratio=:.2f}, type={type(ratio).__name__}")
# 示例输出：ratio=0.88, type=float

3. 常见数据类型实战映射

无论对于基础数据类型、容器集合还是自定义类对象，该方法均能保持一致的输出风格：

# 实战演示：多类型输出对比
user_name = "Alice"
scores = [88, 92, 95]

class UserProfile:
    def __repr__(self):
        return "<UserProfile: id=101>"

profile = UserProfile()

print(f"{user_name=}, type={type(user_name).__name__}")
# 示例输出：user_name='Alice', type=str

print(f"{scores=}, type={type(scores).__name__}")
# 示例输出：scores=[88, 92, 95], type=list

print(f"{profile=}, type={type(profile).__name__}")
# 示例输出：profile=<UserProfile: id=101>, type=UserProfile

提示：类对象的 __qualname__ 进阶用法

如果对象来自嵌套类、局部函数内定义的类或深层包路径，使用 type(obj).__name__ 只会显示最内层的短类名。如果需要查看完整的命名空间路径，可以使用 type(obj).__qualname__，例如会输出 Outer.Inner。

五、版本边界与常见注意事项

在引入该特性时，需要了解以下适用边界与注意事项，避免在特定环境下产生非预期错误：

Python 版本兼容性要求：自说明表达式 {var=} 是在 Python 3.8 中引入的。如果代码需要在 Python 3.7 或更早版本中运行，会直接报 SyntaxError: invalid syntax。对于低版本项目，需回退至传统手动拼接写法。
避免在调试表达式中放入带副作用的函数：自说明表达式支持直接写任意合法 Python 表达式，如 f"{func()=}"。但在格式化时，该函数会被实际执行。切勿将包含数据库写入、网络请求等有状态改变的函数放入调试语句中，以免导致重复调用。
形参与实参的区别：在封装通用的打印函数（如 def debug(x): print(f"{x=}")）时，输出的变量名永远只会是形参名 x，而无法获取调用处外部变量的名称。这是因为自说明语法是在编译期直接提取 AST 中的文本字面量。若需打印调用方变量名，应直接在调用点书写该 f-string。