Python使用format格式化字典列表输出报错的解决方案咨询

我之前也碰到过类似的坑，结合你提到的「元组索引越界」「精度格式非整数」两个报错，咱们一步步拆解解决：

先搞懂报错的核心原因 #

1. 元组索引越界 #

这个报错大概率是占位符和参数不匹配导致的：

• 如果用位置占位符（比如{0}、{1}），但传入的参数数量比占位符少；
• 或者你想用字典的key来匹配占位符，但误写成了位置索引（比如用{0}代替{name}），而字典解包后是关键字参数，不是位置元组，自然找不到对应索引。

2. 精度格式非整数 #

这个问题通常和格式化语法错误或数据类型不匹配有关：

• 格式化小数时，:.xf里的x必须是整数（比如.2f表示保留2位小数），如果写成.2.5f这种非法格式就会报错；
• 要格式化的字段不是数字类型（比如是字符串），却用了数值格式化符号（比如:.2f），也会触发这个错误。

针对字典列表的正确格式化方案 #

先拿一个典型的字典列表示例来演示：

user_list = [
    {"name": "Alice", "age": 28, "score": 92.345},
    {"name": "Bob", "age": 32, "score": "87.6"},  # 注意这里score是字符串
    {"name": "Charlie", "age": 25, "score": 79.1}
]

方案1：用str.format() + 字典解包 #

通过**把字典解包成关键字参数，占位符直接写字典的key即可：

for user in user_list:
    # 处理可能的字符串类型score，先转成float
    formatted_score = float(user["score"]) if isinstance(user["score"], str) else user["score"]
    print("用户: {name}, 年龄: {age}, 得分: {:.2f}".format(**user, score=formatted_score))

方案2：用str.format_map()（更适合字典场景） #

这个方法直接接受字典作为参数，不用手动解包，代码更简洁：

for user in user_list:
    # 先处理数据类型问题，避免原字典被修改
    safe_user = user.copy()
    safe_user["score"] = float(safe_user["score"]) if isinstance(safe_user["score"], str) else safe_user["score"]
    print("用户: {name}, 年龄: {age}, 得分: {score:.2f}".format_map(safe_user))

针对具体报错的修复示例 #

修复「元组索引越界」 #

错误代码（用了位置索引但传入的是字典参数）：

# 错误：{0}是位置索引，但我们传的是**user关键字参数，找不到位置0
print("用户: {0}, 年龄: {1}".format(**user))

修正代码（用字典key作为占位符）：

print("用户: {name}, 年龄: {age}".format(**user))

修复「精度格式非整数」 #

错误代码1（格式化语法错误）：

# 错误：.后面写了非整数的精度
print("得分: {score:.2.5f}".format(**user))

修正代码1：

print("得分: {score:.2f}".format(**user))  # .2f表示保留2位小数

错误代码2（数据类型不匹配）：

# 错误：score是字符串，却用了数值格式化
print("得分: {score:.2f}".format(**user))

修正代码2：

# 先把score转成数字再格式化
print("得分: {:.2f}".format(float(user["score"])))

内容的提问来源于stack exchange，提问作者rishi narian