必须用 excelize.SetCellStyle 绑定样式ID到单元格范围才生效;单独调用 SetFontColor 或 SetBorder 仅构造样式对象,不写入Excel。样式需一次性定义所有属性(字体、边框、填充),通过 NewStyle 获取ID后,用 SetCellStyle 应用于准确范围(尤其合并单元格须覆盖整个区域),颜色用ARGB格式(如"#FFFF0000"),边框数组长度固定为4且顺序为左、右、上、下。

用 excelize.SetCellStyle 才能真正生效样式
直接调用 excelize.SetFontColor 或 excelize.SetBorder 单独设置,不会写入样式——这些函数只是构造样式对象,必须通过 SetCellStyle 绑定到具体单元格范围才起作用。
常见错误是以为调用一次 SetBorder 就自动应用到某个 cell,结果导出后完全没变化。根本原因是 Excel 的样式系统基于「样式 ID」引用,不是即时渲染。
-
SetCellStyle第二个参数是 styleID(int),需先用NewStyle创建并获取 ID - 同一个 styleID 可复用给多个区域,但不能跨工作簿共享
- styleID 从 1 开始计数,0 是默认无样式,别传错
字体颜色和边框必须在同一个 Style 结构里定义
Excelize 不支持分步叠加样式:比如先设红色字体、再加黑色边框,第二次会覆盖第一次的 style 定义。所有视觉属性得一次性塞进 excelize.Style 结构体里。
典型场景是想让 A1 字体红 + 外边框粗 + 背景黄,就得把 Font.Color、Border、Fill 全部填好,再 NewStyle 生成 ID。
立即学习“go语言免费学习笔记(深入)”;
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
Font.Color用 ARGB 格式字符串,如"#FFFF0000"(透明度+RGB),不是纯 "#FF0000" -
Border数组长度固定为 4,顺序是左、右、上、下;漏掉某一项会导致 panic - 边框类型(
Style.Border.Type)填错值(比如写成"thin"而非"thin"对应的常量excelize.BorderThin)会静默失败
合并单元格 + 样式容易丢边框或颜色
对已合并的区域(如 MergeCell)调用 SetCellStyle,只影响左上角单元格的样式引用,其余位置不继承——看起来像边框断开、颜色只在 A1 显示。
正确做法是:先设置样式,再合并;或者合并后,对整个合并区域(如 "A1:C3")统一调用一次 SetCellStyle。
- 合并前设置样式:确保
SetCellStyle(f, "A1", "A1", styleID)在MergeCell之前 - 合并后补样式:用
SetCellStyle(f, "A1", "C3", styleID),范围必须和合并范围完全一致 - 如果合并区域跨行跨列,但只给单个 cell(如 "A1")设样式,Excel 打开时可能报「文件已损坏」
excelize.AutoColor 和自定义色值的区别
字体/填充色用 excelize.AutoColor(值为 -1)时,Excel 会按主题自动适配,但导出后在 LibreOffice 或某些旧版 Excel 中可能显示为黑/白——不是 bug,是主题色解析差异。
生产环境建议一律用确定的 ARGB 值,尤其涉及报表交付时。
-
AutoColor仅适用于快速原型,别用于客户可见输出 - 深色背景配浅色字,别依赖
AutoColor反转逻辑,它不总可靠 - 测试时打开文件用 Excel for Windows/macOS 看真实效果,WPS 和在线预览常有渲染偏差


















