1. Excelize库简介与安装
Excelize是Go语言中处理Excel文件的瑞士军刀,它能轻松读写.xlsx格式文件,支持从基础数据操作到复杂图表生成的全套功能。我在实际项目中使用这个库处理过百万级数据的报表导出,性能表现相当稳定。
安装只需一行命令:
go get github.com/xuri/excelize/v2
推荐使用Go Modules管理依赖,在go.mod文件中会自动记录版本信息。这里有个小技巧:如果遇到网络问题,可以设置GOPROXY环境变量:
export GOPROXY=https://goproxy.cn,direct
2. 基础文件操作
2.1 创建新文件
创建Excel文件就像喝水一样简单:
f := excelize.NewFile()
defer f.Close() // 养成好习惯,及时关闭文件
// 默认会创建Sheet1
f.SetCellValue("Sheet1", "A1", "订单编号")
f.SetCellValue("Sheet1", "B1", "金额")
// 保存文件时建议检查错误
if err := f.SaveAs("orders.xlsx"); err != nil {
log.Fatal("保存失败:", err)
}
2.2 读取现有文件
读取文件时要注意错误处理,特别是文件不存在的情况:
f, err := excelize.OpenFile("orders.xlsx")
if err != nil {
if os.IsNotExist(err) {
log.Fatal("文件不存在")
}
log.Fatal("打开文件失败:", err)
}
defer f.Close()
// 获取单元格值
value, err := f.GetCellValue("Sheet1", "A1")
if err != nil {
log.Fatal("读取单元格失败:", err)
}
fmt.Println("A1的值:", value)
// 整表读取技巧
rows, err := f.GetRows("Sheet1")
for i, row := range rows {
fmt.Printf("第%d行: %v\n", i+1, row)
}
3. 工作表高级操作
3.1 多工作表管理
实际项目中经常需要操作多个工作表:
// 创建新工作表
index := f.NewSheet("统计报表")
f.SetActiveSheet(index) // 设为当前活动表
// 批量创建工作表
sheets := []string{"月度汇总", "季度汇总", "年度汇总"}
for _, name := range sheets {
f.NewSheet(name)
}
// 删除工作表要小心数据丢失
if err := f.DeleteSheet("Sheet1"); err != nil {
log.Println("删除工作表失败:", err)
}
// 重命名工作表
f.SetSheetName("统计报表", "销售统计")
3.2 行列操作技巧
处理行列时这些方法很实用:
// 设置列宽(单位:字符)
f.SetColWidth("销售统计", "A", "D", 15)
// 设置行高(单位:磅)
f.SetRowHeight("销售统计", 1, 30)
// 插入行列(在第2行前插入1行)
f.InsertRows("销售统计", 2, 1)
// 合并单元格要特别注意边界情况
f.MergeCell("销售统计", "A1", "D1")
4. 样式设置实战
4.1 基础样式配置
让报表美观的关键在于样式:
// 创建样式
style, err := f.NewStyle(&excelize.Style{
Font: &excelize.Font{
Bold: true,
Color: "#FF0000",
Family: "微软雅黑",
Size: 12,
},
Alignment: &excelize.Alignment{
Horizontal: "center",
Vertical: "center",
},
Border: []excelize.Border{
{Type: "left", Color: "#000000", Style: 1},
{Type: "right", Color: "#000000", Style: 1},
},
Fill: excelize.Fill{
Type: "pattern", Color: []string{"#F0F0F0"}, Pattern: 1},
})
if err != nil {
log.Fatal("创建样式失败:", err)
}
// 应用样式
f.SetCellStyle("销售统计", "A1", "D1", style)
4.2 条件格式
自动高亮异常数据:
// 红绿灯条件格式
err = f.SetConditionalFormat("销售统计", "B2:B100", `{
"type": "data_bar",
"criteria": ">",
"value": "10000",
"format": 3
}`)
5. 图表与多媒体
5.1 生成专业图表
制作销售趋势图示例:
if err := f.AddChart("销售统计", "E1", `{
"type": "line",
"series": [
{
"name": "销售统计!$A$1",
"categories": "销售统计!$B$1:$D$1",
"values": "销售统计!$B$2:$D$2"
}
],
"title": {"name": "月度销售趋势"}
}`); err != nil {
log.Fatal("添加图表失败:", err)
}
5.2 插入图片
添加公司logo的注意事项:
// 支持png/jpeg/gif格式
if err := f.AddPicture("销售统计", "A1", "logo.png", `{
"x_offset": 10,
"y_offset": 10,
"x_scale": 0.5,
"y_scale": 0.5
}`); err != nil {
log.Fatal("插入图片失败:", err)
}
6. 高性能流式处理
6.1 大数据量导出
处理百万数据时的正确姿势:
sw, err := f.NewStreamWriter("大数据")
if err != nil {
log.Fatal(err)
}
// 设置列宽
if err := sw.SetColWidth(1, 10, 20); err != nil {
log.Fatal(err)
}
// 批量写入
for rowID := 1; rowID <= 100000; rowID++ {
row := make([]interface{}, 10)
for colID := 0; colID < 10; colID++ {
row[colID] = fmt.Sprintf("值%d-%d", rowID, colID)
}
cell, _ := excelize.CoordinatesToCellName(1, rowID)
if err := sw.SetRow(cell, row); err != nil {
log.Fatal(err)
}
}
// 必须调用Flush
if err := sw.Flush(); err != nil {
log.Fatal(err)
}
6.2 内存优化技巧
使用临时文件减少内存占用:
f := excelize.NewFile()
f.Path = "/tmp/temp.xlsx" // 设置临时文件路径
// ...操作文件...
f.SaveAs("final.xlsx")
7. 实战经验分享
在实际项目中使用Excelize遇到过几个典型问题:
- 并发写入时记得加锁,虽然v2.3.0+支持并发SetCellValue,但整体文件操作仍需同步
- 处理中文路径时要注意编码问题,建议使用绝对路径
- 样式对象不要重复创建,相同的样式应该复用
- 大文件处理时及时调用Close()释放资源
一个实用的错误处理封装:
func writeCell(f *excelize.File, sheet, cell, value string) {
if err := f.SetCellValue(sheet, cell, value); err != nil {
log.Printf("写入单元格%s失败: %v", cell, err)
// 可以考虑重试机制
}
}
6万+



被折叠的 条评论
为什么被折叠?



