如何在Python自文档化f-string的等号后插入换行符？

好问题！这个确实是Python 3.8自文档化f-string的小痛点——当处理numpy数组这类多行输出的对象时，默认的{var=}格式会把值紧紧贴在变量名后面，可读性大打折扣，而手动重复变量名又违背了这个特性“少写重复代码”的初衷。

遗憾的是，目前f-string的格式规范迷你语言并没有直接提供在=后插入换行的语法，但我们可以用几个变通方法来实现需求，同时避免手动重复变量名：

方法1：拆分自文档化字符串拼接 #

利用{var=}生成的字符串自带变量名=值的结构，我们可以拆分出变量名部分，再和换行后的值拼接：

import numpy as np

some_fairly_long_named_arr = np.random.rand(3, 3)
# 从自文档化字符串中提取变量名
var_name = f"{some_fairly_long_named_arr=}".split('=', 1)[0]
# 拼接换行和值输出
print(f"{var_name}=\n{some_fairly_long_named_arr!r}")

这个方法的优势是不用手动硬编码变量名字符串，避免了拼写错误，同时保留了自文档化的核心价值。

方法2：封装成工具函数（推荐） #

如果需要频繁处理这类场景，最好把逻辑封装成一个可复用的函数，这样调用起来更简洁：

import numpy as np

def print_named_var(var, repr_style='!r'):
    """打印带变量名的对象，自动在=后换行"""
    # 利用自文档化f-string获取变量名
    named_str = f"{var=}"
    var_name, _ = named_str.split('=', 1)
    # 根据指定格式处理值的输出
    if repr_style == '!r':
        val_str = repr(var)
    elif repr_style == '!s':
        val_str = str(var)
    else:
        # 支持自定义格式规范，比如保留小数位等
        val_str = f"{var:{repr_style}}"
    print(f"{var_name}=\n{val_str}")

# 使用示例
some_fairly_long_named_arr = np.random.rand(3, 3)
print_named_var(some_fairly_long_named_arr)
# 也可以指定格式，比如numpy数组用默认打印风格
print_named_var(some_fairly_long_named_arr, repr_style='!s')

这个函数只需要传入变量本身，内部自动处理变量名提取和换行逻辑，完全不用重复变量名，完美契合自文档化f-string的设计初衷。

为什么直接换行不行？ #

你尝试的print(f"{some_fairly_long_named_arr= }")会触发语法错误，是因为f-string的表达式部分（{}内部的内容）不允许直接换行，即便用括号包裹，换行也会被当作语法的一部分，不会被解析成输出中的换行符，所以这种方式行不通。

内容的提问来源于stack exchange，提问作者Enigma Machine