Pandas导出CSV时如何让各列名分别显示在独立列中

问题原因 #

• 不同地区版本的Excel默认列分隔符存在差异，国内/欧洲等地区版本默认将分号、制表符识别为CSV分隔符，而非逗号，会导致逗号分隔的文件打开后内容全部挤在同一列
• 导出未指定带BOM的UTF-8编码时，Excel会出现编码识别错误，进一步引发格式错乱
• hyperAPI读取CSV时如果配置的分隔符和导出时的分隔符不匹配，就会触发列数过少的报错

修复方案 #

方案1：导出适配Excel默认规则的CSV #

修改to_csv参数，指定分号为分隔符+带BOM的UTF-8编码，Excel打开后会自动识别分列：

df.to_csv("./file.csv", index=False, sep=';', encoding='utf-8-sig')

hyperAPI读取该文件时，同步指定分隔符为分号即可，以Tableau Hyper API的Python调用为例：

# 读取CSV时指定分隔符和导出配置一致
csv_options = hyper.CSVOptions(delimiter=';')
# 后续按原有逻辑导入即可

方案2：导出为制表符分隔的TSV文件 #

如果不想调整原有hyperAPI的分隔符配置，也可以选择导出为所有工具兼容性更好的TSV格式：

df.to_csv("./file.tsv", index=False, sep='\t', encoding='utf-8-sig')

hyperAPI读取时指定delimiter='\t'即可。

临时Excel端修复（无需修改导出逻辑） #

如果仅需要单次查看CSV内容，不需要批量处理，可打开Excel后点击「数据」选项卡-「自文本/CSV」，选择目标文件后手动指定逗号作为分隔符，即可完成正确分列。

验证步骤 #

导出文件后用系统自带的记事本打开，检查列分隔符是否统一、表头和数据是否一一对应，即可排除导出阶段的逻辑错误。

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