torch 报错 unsupported format string passed to torch.FloatTensor.format张量打印精度、单值 i

这个报错本质是 Python 格式化字符串直接对整张 torch 张量使用格式化语法（比如 f"{tensor:.4f}"），PyTorch 的 Tensor 本身不支持直接用 format 格式化；只有 0 维单元素张量（可以用.item () 取出 Python 数值）才支持精度格式化，整张张量不能直接套 :.2f 这类格式符，很多人写代码时混用整张量和单值张量打印逻辑，就会触发这个异常。简单区分：如果是标量张量，调用 .item () 转成 float 后再格式化；如果是多维整张张量，不能直接 f-string 格式化，要改用 torch.set_printoptions 全局设置打印精度，或者先转 numpy、循环逐个处理元素。

一、错误复现代码

import torch

t = torch.tensor([1.23456, 2.34567])

print(f"{t:.4f}") ❌ 报错：unsupported format string passed to torch.FloatTensor.__format__

二、两种场景正确写法对比

三、torch.set_printoptions 常用参数

• precision：保留小数位数，控制浮点数精度
• sci_mode：是否开启科学计数法，True/False
• threshold：超过多少元素触发缩略打印
• linewidth：打印换行宽度

示例：

torch.set_printoptions(precision=4, sci_mode=False)

四、踩坑要点

1. 不要把整张张量直接放进 f"{xxx:.Nf}"，这是报错根源；
2. .item() 只能用于 0 维标量张量，多维张量调用.item () 会直接抛另一个错误；
3. set_printoptions 是全局生效，会影响后续所有 print 张量；
4. 如果不想全局改动，优先用 numpy 转换或者循环格式化。

五、推荐封装工具函数

def format_tensor(t, dec=4):

if t.numel() == 1:

return f"{t.item():.{dec}f}"

else:

return str(torch.round(t, decimals=dec))

【相关 FAQ】

问题 1：unsupported format string passed to torch.FloatTensor.format，为什么整张张量不能直接用 f-string 设置精度？

回答 1：unsupported format string passed to torch.FloatTensor.__format__这个报错，是因为 PyTorch 的 Tensor 没有实现__format__接口，Python 的格式化语法不支持直接对整张张量设置小数精度，只有取出.item () 后的原生数值才支持。

问题 2：遇到 unsupported format string passed to torch.FloatTensor.format，标量张量用.it () 还是.item ()？

回答 2：正确是.item ()，没有.it 这个接口；遇到 unsupported format string passed to torch.FloatTensor.format，0 维单值张量调用.item () 取出 Python 浮点数，再做格式化。

问题 3：不想全局 set_printoptions，怎么打印张量并控制精度，避免 unsupported format string passed to torch.FloatTensor.format？

回答 3：不想全局设置，可以把张量转 numpy 数组，用列表推导遍历每个元素单独格式化，或者 torch.round 之后再打印，这样不会触发 unsupported format string passed to torch.FloatTensor.format。

问题 4：torch.set_printoptions 设置精度之后，对.item () 取出的数值打印生效吗？

回答 4：torch.set_printoptions 只控制 print 直接打印张量对象的输出，对.item () 拿到的原生 float 没有约束，原生 float 的精度需要自己在 f-string 里指定。

【参考资料】

[2026-11-09]（PyTorch Tensor format string 报错官方说明）PyTorch Docs

[2026-03-12]（unsupported format string passed to torch.FloatTensor.format 解决）Stack Overflow

[2025-08-20]（torch.set_printoptions 使用教程）PyTorch 中文文档

[2026-01-15]（tensor.item () 标量取值注意事项）知乎技术专栏

【免责声明】

本文内容基于 PyTorch 常规版本调试总结，不同 PyTorch 版本打印行为略有差异，代码仅用于调试参考，不保证适配所有特殊自定义张量子类。