Golang Excelize 2.5.0 发布 - 电子表格(Excel)文档 API

Excelize 2.5.0 的发布带来了许多重要更新，特别是新增的API和对公式函数的支持，这大大增强了库的功能性。以下是一些关键特性的示例代码：

1. 使用 SetRowStyle 为整行设置样式

package main

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 创建样式
    style, err := f.NewStyle(&excelize.Style{
        Font: &excelize.Font{Color: "FF0000", Bold: true},
    })
    if err != nil {
        fmt.Println(err)
        return
    }
    // 为第2行设置样式
    if err := f.SetRowStyle("Sheet1", 2, 2, style); err != nil {
        fmt.Println(err)
        return
    }
    // 保存文件
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

2. 使用 GetCellType 获取单元格数据类型

package main

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

func main() {
    f, err := excelize.OpenFile("Book1.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 获取A1单元格的数据类型
    cellType, err := f.GetCellType("Sheet1", "A1")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(cellType) // 输出: string, number, bool, date, formula, error 等
}

3. 使用 SetAppProps 和 GetAppProps 管理文档属性

package main

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 设置应用程序属性
    if err := f.SetAppProps(&excelize.AppProperties{
        Application:       "My Go Application",
        ScaleCrop:         true,
        DocSecurity:       3,
        Company:           "Go Tech",
        LinksUpToDate:     false,
        HyperlinksChanged: false,
        AppVersion:        "1.0.0",
    }); err != nil {
        fmt.Println(err)
        return
    }
    // 获取应用程序属性
    props, err := f.GetAppProps()
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Printf("Application: %s\n", props.Application)
    fmt.Printf("Company: %s\n", props.Company)
}

4. 使用新增的公式函数（例如 XLOOKUP）

package main

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 在A1:A3写入查找值
    f.SetCellValue("Sheet1", "A1", "Apple")
    f.SetCellValue("Sheet1", "A2", "Banana")
    f.SetCellValue("Sheet1", "A3", "Cherry")
    // 在B1:B3写入对应的结果
    f.SetCellValue("Sheet1", "B1", 10)
    f.SetCellValue("Sheet1", "B2", 20)
    f.SetCellValue("Sheet1", "B3", 30)
    // 在C1设置XLOOKUP公式查找"Banana"
    f.SetCellFormula("Sheet1", "C1", "=XLOOKUP(\"Banana\",A1:A3,B1:B3)")
    // 计算公式结果
    result, err := f.CalcCellValue("Sheet1", "C1")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(result) // 输出: 20
}

5. 流式写入器设置行样式

package main

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 创建样式
    style, err := f.NewStyle(&excelize.Style{Fill: excelize.Fill{Type: "pattern", Color: []string{"E0EBF5"}, Pattern: 1}})
    if err != nil {
        fmt.Println(err)
        return
    }
    streamWriter, err := f.NewStreamWriter("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
    }
    // 设置第5行的样式
    if err := streamWriter.SetRow("A5", []interface{}{excelize.Cell{Value: "Streaming row with style"}}, excelize.RowOpts{StyleID: style}); err != nil {
        fmt.Println(err)
        return
    }
    if err := streamWriter.Flush(); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

这些示例展示了Excelize 2.5.0中新增API的基本用法。需要注意的是，使用行迭代器后必须关闭流，打开现有电子表格后也需要关闭文件，这是该版本兼容性要求的重要变更。