使用Pandas读取Excel文件并保留原始行号的实现方案

你当前的代码里，rows = file.values会把DataFrame转成纯数值数组，彻底丢失了和原始Excel行号的关联。要实现带行号的异常，必须在整个数据处理流程中保留原始行号的追踪，具体实现如下：

1. 读取Excel时标记原始行号 #

不要直接转成values，而是给DataFrame添加一列记录原始Excel的行号。注意：Excel默认表头是第1行，数据行从第2行开始，因此DataFrame的索引（从0开始）加2就是对应的Excel行号：

try:
    book = xlrd.open_workbook(file_contents=filecontent)
    df = pd.read_excel(book)
    # 添加原始Excel行号列，若表头不是第1行，自行调整偏移量
    df['excel_row'] = df.index + 2
    ...
# 后续用df而非values处理数据

2. 排序时保留行号关联 #

如果需要保留你自定义的排序逻辑，不要直接对values数组排序，而是把行号和数据绑定成元组后再排序：

# 将行号与数据打包，保留关联关系
rows_with_row = [(row['excel_row'], row.drop('excel_row').values) for _, row in df.iterrows()]

# 执行原有排序逻辑
rows_with_row_sorted = sorted(
    rows_with_row,
    key=lambda item: '' if not nan_to_none(item[1][columns_map['order_name']]) else item[1][columns_map['order_name']]
)

3. 处理数据时抛出带行号的异常 #

遍历排序后的列表，处理每行数据时捕获异常，并带上原始Excel行号：

for excel_row_num, row_data in rows_with_row_sorted:
    try:
        # 你的数据处理逻辑
        ...
    except Exception as original_err:
        # 抛出包含行号的异常，保留原始异常栈便于排查
        raise RuntimeError(f"原始Excel第{excel_row_num}行处理失败: {str(original_err)}") from original_err

更简洁的替代方案：直接用DataFrame排序 #

如果你的排序逻辑可以用Pandas内置方法实现，推荐直接操作DataFrame，代码更简洁且天然保留行号：

# 用fillna处理空值，实现和你原有key一致的排序规则
df_sorted = df.sort_values(
    by=columns_map['order_name'],
    key=lambda col: col.fillna('')
)

# 遍历处理排序后的DataFrame
for _, row in df_sorted.iterrows():
    excel_row_num = row['excel_row']
    try:
        # 直接通过row访问列数据，比如row[columns_map['xxx']]
        ...
    except Exception as original_err:
        raise RuntimeError(f"原始Excel第{excel_row_num}行处理失败: {str(original_err)}") from original_err

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