在 Go 中使用 xlsx 库（如 tealeg/xlsx）写入含 \n 的字符串时，需显式启用单元格的“自动换行（Wrap Text）”样式，否则换行符仅被存储而不会渲染为视觉换行；本文详解如何通过 Alignment.WrapText = true 实现真正的单元格内换行显示。
在 go 中使用 xlsx 库（如 tealeg/xlsx）写入含 `\n` 的字符串时，需显式启用单元格的“自动换行（wrap text）”样式，否则换行符仅被存储而不会渲染为视觉换行；本文详解如何通过 `alignment.wraptext = true` 实现真正的单元格内换行显示。
要在 Excel 单元格中正确显示换行符（例如 \n），仅写入带换行符的字符串是不够的——Excel 默认会忽略换行，除非该单元格启用了“自动换行（Wrap Text）”样式。Go 生态中主流 xlsx 库（如 github.com/tealeg/xlsx）均支持通过样式（Style）控制此行为。
以 tealeg/xlsx 为例，核心步骤如下：
-
创建自定义样式：构造一个
xlsx.Style实例，并配置其Alignment字段； -
启用换行：将
Alignment.WrapText设为true； -
应用样式：将该样式赋给目标单元格（
cell.SetStyle(style)）； -
写入含
\n的内容：调用cell.SetValue("第一行\n第二行")。
✅ 完整示例代码：
package main
import (
"log"
"github.com/tealeg/xlsx"
)
func main() {
// 创建工作簿与工作表
file := xlsx.NewFile()
sheet, err := file.AddSheet("Sheet1")
if err != nil {
log.Fatal(err)
}
// 创建启用自动换行的样式
style := xlsx.Style{}
style.Alignment.WrapText = true // ? 关键：启用换行
// 获取单元格并设置样式与内容
row := sheet.AddRow()
cell := row.AddCell()
cell.SetStyle(&style)
cell.SetValue("Hello\nWorld\nGo Excel") // 包含 \n
// 保存文件
if err := file.Save("wrapped_cell.xlsx"); err != nil {
log.Fatal(err)
}
log.Println("✅ 文件已生成，打开后可见自动换行效果")
}
⚠️ 注意事项：
-
tealeg/xlsx已归档（archived），推荐新项目优先考虑更活跃的替代库，如excelize（其等效写法为cell.SetWrapText(true)，API 更简洁）； - 即使启用了
WrapText，若列宽过窄，Excel 可能仍不显示完整多行——建议在导出后适当调整列宽，或通过代码调用sheet.SetColWidth(0, 0, 25)预设合理宽度； -
\r\n与\n在tealeg/xlsx中效果一致，无需特殊处理； - 样式对象应复用（避免每单元格新建），提升性能与内存效率。
总结：换行显示 = 内容含 \n + 样式 WrapText = true，二者缺一不可。掌握这一组合，即可在 Go 导出的 Excel 中实现专业、可读的多行文本呈现。
