Golang生成CSV时Excel未分列的问题排查与解决

以下是几个实用的解决方案：

1. 改用分号作为CSV分隔符 #

很多地区（如欧洲）的Excel默认用分号作为CSV列分隔符，而非逗号。修改Golang代码中的分隔符为分号即可：

// 示例：替换逗号为分号生成CSV行
linhaCSV := fmt.Sprintf("%s;%s;%s", item.NomeFornecedor, item.NomeProduto, item.OutroCampo)

生成的CSV文件直接用Excel打开就能自动分列。

2. 通过Excel数据导入功能手动指定分隔符 #

如果不想修改代码，可通过Excel的导入流程强制识别逗号分隔：

• 打开Excel，切换到「数据」选项卡
• 点击「自文本/CSV」，选择你的CSV文件
• 在导入预览界面，点击「编辑」，在分隔符选项中勾选「逗号」
• 确认后完成导入，数据会正确拆分到不同列

3. 给CSV添加UTF-8 BOM头 #

部分旧版Excel对无BOM的UTF-8 CSV解析存在问题，在生成CSV内容开头添加UTF-8 BOM标记：

// 在CSV内容开头加入BOM
csvContent := "\ufeff"
// 写入表头
csvContent += "NomeFornecedor,NomeProduto,Preco\n"
// 遍历数据生成行
for _, item := range dados {
    csvContent += fmt.Sprintf("%s,%s,%.2f\n", item.NomeFornecedor, item.NomeProduto, item.Preco)
}
// 后续将csvContent写入响应或文件

4. 处理含特殊字符的字段 #

如果字段内容本身包含逗号、双引号，需用双引号包裹字段，同时转义内部的双引号：

// 转义字段内的双引号，并用双引号包裹字段
fornecedor := strings.ReplaceAll(item.NomeFornecedor, "\"", "\"\"")
produto := strings.ReplaceAll(item.NomeProduto, "\"", "\"\"")
linhaCSV := fmt.Sprintf("\"%s\",\"%s\"", fornecedor, produto)

避免内容中的逗号被误判为列分隔符。

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