Python中将元组列表保存至CSV文件时遭遇索引错误的技术问询

问题根源 #

你遇到的IndexError: tuple index out of range原因很明确：你的元组列表里并非所有元组都包含4个元素。看你的data就能发现，前4个元组是4个元素（最后一个是列表类型），但最后两个元组只有3个元素——当代码尝试访问r[3]时，自然找不到这个索引，直接触发错误。

另外，你手动拼接CSV的方式还有个隐形坑：那些列表类型的元素（比如[14,37,41]）直接转字符串后，里面的逗号会被当成CSV的列分隔符，导致后续读取时列数混乱。

最优解决方案：用内置csv模块处理 #

Python的csv模块就是专门处理这类场景的，它能自动适配不同长度的行，还能正确转义特殊字符。下面是修改后的完整代码：

import os
import csv

def save_csv(data, path, filename):
    # 先确保保存目录存在，避免路径不存在报错
    os.makedirs(path, exist_ok=True)
    full_path = os.path.join(path, f"{filename}_data.csv")
    
    with open(full_path, "w", newline="", encoding="utf-8") as outfile:
        writer = csv.writer(outfile)
        for row in data:
            # 把元组转成列表，方便补全长度
            processed_row = list(row)
            # 如果行长度不足4，补上空字符串（你也可以换成其他默认值，比如"NA"）
            while len(processed_row) < 4:
                processed_row.append("")
            # 把列表类型的元素转成用分号分隔的字符串，避免逗号干扰CSV列
            if isinstance(processed_row[3], list):
                processed_row[3] = ";".join(map(str, processed_row[3]))
            writer.writerow(processed_row)

# 测试你的数据
data = [(1633098324445950024, 139.55, 15, [14, 37, 41]), (1633098324445958000, 139.55, 100, [14, 41]), (1633098324445958498, 139.55, 60, [14, 37, 41]), (1633098324446013523, 139.55, 52, [14, 37, 41]), (1633098324472392943, 139.555, 100), (1633098324478972256, 139.555, 100)]
save_csv(data, "./output", "test")

如果你坚持手动拼接（不推荐） #

要是你不想用csv模块，就得手动处理每个元组的长度，同时转义列表里的逗号：

import os

def save_csv(data, path, filename):
    os.makedirs(path, exist_ok=True)
    full_path = os.path.join(path, f"{filename}_data.csv")
    
    lines = []
    for r in data:
        # 取出前3个必有的元素
        col1, col2, col3 = r[:3]
        # 处理第4列：存在就转成分号分隔的字符串，不存在就为空
        col4 = ";".join(map(str, r[3])) if len(r) >= 4 else ""
        lines.append(f"{col1},{col2},{col3},{col4}")
    
    with open(full_path, "w", encoding="utf-8") as outfile:
        outfile.write("\n".join(lines))

最终效果 #

两种方法都会生成格式正确的CSV：

• 前4行的第4列会是14;37;41这样的格式，不会因为逗号打乱CSV列
• 最后两行的第4列是空值，完全避免了索引越界问题

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