Python pandas使用set_column设置Excel列格式时第一列不生效问题

问题根因 #

这是pandas搭配xlsxwriter使用时的常见格式优先级问题：pandas写入datetime类型的列时，会自动给每个单元格添加默认的日期格式，单元格级别的格式优先级高于set_column设置的列级格式，因此你设置的列格式被单元格级别的默认格式覆盖，导致第一列不生效。
另外你提供的示例代码存在小缺陷：循环for column in df没有同步更新列索引idx，如果实际运行代码也存在这个问题，也可能导致第一列格式设置错误，建议改为通过enumerate遍历获取索引。 #

解决方案 #

你可以根据自己的需求选择以下任意一种方法解决：

• 方法1：写入DataFrame时统一指定日期格式
  调用to_excel时添加datetime_format参数，匹配你需要的全局格式即可，示例代码：

  # 定义全局通用格式，添加日期格式配置
  common_format = writer.book.add_format({
      'text_wrap': True, 
      'align': 'left', 
      'valign': 'top',
      'num_format': 'yyyy-mm-dd' # 替换为你需要的日期格式
  })
  # 写入时指定日期默认格式
  df.to_excel(writer, sheet_name=sheet_name, index=False, datetime_format='yyyy-mm-dd')
  # 遍历设置所有列的宽度和格式
  for idx, col in enumerate(df):
      # col_len_list为你预先计算的各列宽度列表
      writer.sheets[sheet_name].set_column(idx, idx, col_len_list[idx], common_format)
  

• 方法2：单独覆盖第一列的单元格格式
  写入完成后遍历第一列的数据行，手动替换pandas自动添加的默认格式：

  common_format = writer.book.add_format({
      'text_wrap': True, 
      'align': 'left', 
      'valign': 'top',
      'num_format': 'yyyy-mm-dd'
  })
  df.to_excel(writer, sheet_name=sheet_name, index=False)
  # 重写第一列的单元格格式，数据行从1开始（第0行为表头）
  for row in range(1, len(df)+1):
      writer.sheets[sheet_name].write(row, 0, df.iloc[row-1, 0], common_format)
  # 再批量设置所有列的宽度
  for idx, col in enumerate(df):
      writer.sheets[sheet_name].set_column(idx, idx, col_len_list[idx], common_format)
  

• 方法3：提前转换日期列为字符串格式
  不需要保留日期类型的场景可以用这个方法，处理后列格式设置会直接生效：

  # 替换为你的第一列列名，日期格式可自定义
  df['第一列列名'] = df['第一列列名'].dt.strftime('%Y-%m-%d')
  # 之后正常执行写入和列格式设置逻辑即可
  

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