Golang Excelize 2.4.1 发布：强大的电子表格处理 API

是的——我一直觉得有点好笑，OpenXML SDK 是微软开发的，但它却是处理 XLSX 最糟糕的库之一。它速度很快，但是天哪，要让输出完美无缺真是太痛苦了。EPPlus 还行，但在我使用 OpenXML 的那个项目时期，EPPlus 不支持 .NET Core，所以它根本不在考虑范围内。

Excelize 2.4.1 的发布确实带来了许多重要的改进和新特性，特别是在并发安全性和流式API方面。以下是对其中一些关键特性的代码示例说明：

1. 流模式下设置列宽和合并单元格

现在可以在流式写入时动态设置列宽和合并单元格，这对于处理大型数据集非常有用。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    streamWriter, err := f.NewStreamWriter("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
    }
    
    // 设置列宽
    if err := streamWriter.SetColWidth(2, 2, 20); err != nil {
        fmt.Println(err)
        return
    }
    
    // 合并单元格
    if err := streamWriter.MergeCell("A1", "C1"); err != nil {
        fmt.Println(err)
        return
    }
    
    // 写入数据
    if err := streamWriter.SetRow("A1", []interface{}{"合并的标题"}); err != nil {
        fmt.Println(err)
        return
    }
    
    if err := streamWriter.Flush(); err != nil {
        fmt.Println(err)
        return
    }
    
    if err := f.SaveAs("流式写入示例.xlsx"); err != nil {
        fmt.Println(err)
    }
}

2. 并发安全操作示例

多个函数现在支持并发安全调用，这对于高并发场景下的性能提升很有帮助。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
    "sync"
)

func main() {
    f := excelize.NewFile()
    var wg sync.WaitGroup
    
    // 并发设置单元格样式
    for i := 1; i <= 10; i++ {
        wg.Add(1)
        go func(row int) {
            defer wg.Done()
            style, _ := f.NewStyle(&excelize.Style{
                Font: &excelize.Font{Bold: true},
            })
            cell := fmt.Sprintf("A%d", row)
            f.SetCellValue("Sheet1", cell, fmt.Sprintf("并发行%d", row))
            f.SetCellStyle("Sheet1", cell, cell, style)
        }(i)
    }
    
    wg.Wait()
    f.SaveAs("并发示例.xlsx")
}

3. 新增公式函数使用

新增的BESSELK和BESSELY函数可以在公式计算中使用。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    
    // 设置基础数据
    f.SetCellValue("Sheet1", "A1", 5.0)
    f.SetCellValue("Sheet1", "A2", 2.0)
    
    // 使用BESSELK函数
    f.SetCellFormula("Sheet1", "B1", "BESSELK(A1, A2)")
    
    // 使用BESSELY函数
    f.SetCellFormula("Sheet1", "B2", "BESSELY(A1, A2)")
    
    // 计算公式结果
    result1, _ := f.CalcCellValue("Sheet1", "B1")
    result2, _ := f.CalcCellValue("Sheet1", "B2")
    
    fmt.Printf("BESSELK结果: %s\n", result1)
    fmt.Printf("BESSELY结果: %s\n", result2)
    
    f.SaveAs("公式示例.xlsx")
}

4. 定义名称引用支持

公式计算引擎现在支持通过定义名称来引用数据范围。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    
    // 设置数据
    data := []interface{}{10, 20, 30, 40, 50}
    for i, value := range data {
        cell := fmt.Sprintf("A%d", i+1)
        f.SetCellValue("Sheet1", cell, value)
    }
    
    // 定义名称
    if err := f.SetDefinedName(&excelize.DefinedName{
        Name:     "MyData",
        RefersTo: "Sheet1!$A$1:$A$5",
        Comment:  "自定义数据范围",
    }); err != nil {
        fmt.Println(err)
        return
    }
    
    // 在公式中使用定义名称
    f.SetCellFormula("Sheet1", "B1", "SUM(MyData)")
    
    // 计算公式
    result, _ := f.CalcCellValue("Sheet1", "B1")
    fmt.Printf("使用定义名称的计算结果: %s\n", result)
    
    f.SaveAs("定义名称示例.xlsx")
}

5. 时间处理改进

不再需要将时间转换为UTC时区，简化了时间值的设置。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
    "time"
)

func main() {
    f := excelize.NewFile()
    
    // 直接使用本地时间
    localTime := time.Now()
    f.SetCellValue("Sheet1", "A1", localTime)
    
    // 设置时间格式
    style, _ := f.NewStyle(&excelize.Style{
        NumFmt: 22, // 时间格式
    })
    f.SetCellStyle("Sheet1", "A1", "A1", style)
    
    // 读取时间值
    cellValue, _ := f.GetCellValue("Sheet1", "A1")
    fmt.Printf("单元格时间值: %s\n", cellValue)
    
    f.SaveAs("时间处理示例.xlsx")
}

这些示例展示了Excelize 2.4.1版本中一些重要新特性的使用方法。特别是并发安全性的改进使得在高并发场景下处理Excel文件更加高效可靠。