Golang Excel文档处理库Excelize 2.6.0版本发布

Excelize 2.6.0版本的发布确实带来了许多重要的改进和新功能，对于处理Excel文档的Go开发者来说是一个值得关注的更新。以下是一些关键点的技术解析和示例代码：

1. 工作表保护算法的增强

ProtectSheet 现在支持多种哈希算法，这增强了工作表保护的安全性。以下是使用SHA256算法保护工作表的示例：

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)
        }
    }()
    // 创建新工作表
    index, _ := f.NewSheet("Sheet2")
    // 设置单元格值
    f.SetCellValue("Sheet2", "A1", "Hello")
    // 使用SHA256算法保护工作表
    if err := f.ProtectSheet("Sheet2", &excelize.FormatSheetProtection{
        AlgorithmName: "SHA-256",
        Password:      "password",
    }); err != nil {
        fmt.Println(err)
        return
    }
    // 设置工作簿的活动工作表
    f.SetActiveSheet(index)
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

2. 新增公式函数支持

新增的71个公式函数大大扩展了Excelize的计算能力。以下是使用新增的SUMIFS函数的示例：

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)
        }
    }()
    // 设置单元格值
    data := [][]interface{}{
        {"Item", "Region", "Sales"},
        {"Apple", "North", 100},
        {"Apple", "South", 200},
        {"Orange", "North", 150},
        {"Orange", "South", 250},
    }
    for i, row := range data {
        cell, _ := excelize.CoordinatesToCellName(1, i+1)
        f.SetSheetRow("Sheet1", cell, &row)
    }
    // 设置SUMIFS公式
    f.SetCellFormula("Sheet1", "B6", "SUMIFS(C2:C5, A2:A5, \"Apple\", B2:B5, \"North\")")
    // 计算公式
    result, _ := f.CalcCellValue("Sheet1", "B6")
    fmt.Printf("SUMIFS result: %s\n", result) // 输出: 100
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

3. 布尔数据类型支持

现在可以直接读取布尔类型的单元格值，这简化了布尔数据的处理：

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)
        }
    }()
    // 设置布尔值
    f.SetCellValue("Sheet1", "A1", true)
    f.SetCellValue("Sheet1", "A2", false)
    // 读取布尔值
    val1, _ := f.GetCellValue("Sheet1", "A1")
    val2, _ := f.GetCellValue("Sheet1", "A2")
    fmt.Printf("A1: %s, A2: %s\n", val1, val2) // 输出: A1: true, A2: false
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

4. 工作簿属性设置

新增的SetWorkbookPrOptions函数允许设置工作簿的FilterPrivacy和CodeName属性：

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.SetWorkbookPrOptions(
        excelize.FilterPrivacy(true),
        excelize.CodeName("MyWorkbook"),
    ); err != nil {
        fmt.Println(err)
        return
    }
    // 获取工作簿属性
    opts, _ := f.GetWorkbookPrOptions()
    fmt.Printf("FilterPrivacy: %v, CodeName: %s\n", 
        opts.FilterPrivacy, opts.CodeName)
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

5. 环形图孔洞大小设置

现在可以在创建环形图时设置孔洞大小：

package main

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            panic(err)
        }
    }()
    // 设置图表数据
    for idx, row := range [][]interface{}{
        {"Apple", "Orange"},
        {10, 20},
    } {
        cell, _ := excelize.CoordinatesToCellName(1, idx+1)
        f.SetSheetRow("Sheet1", cell, &row)
    }
    // 创建环形图并设置孔洞大小
    if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
        Type: excelize.Doughnut,
        Series: []excelize.ChartSeries{
            {
                Name:       "Sheet1!$A$1",
                Categories: "Sheet1!$A$2:$B$2",
                Values:     "Sheet1!$A$3:$B$3",
            },
        },
        Format: excelize.GraphicOptions{
            OffsetX: 15,
            OffsetY: 10,
        },
        Legend: excelize.ChartLegend{
            Position: "left",
        },
        Title: excelize.ChartTitle{
            Name: "环形图示例",
        },
        Doughnut: &excelize.DoughnutChartOptions{
            HoleSize: 50, // 设置孔洞大小为50%
        },
    }); err != nil {
        panic(err)
    }
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        panic(err)
    }
}

6. 错误处理改进

新增的导出错误类型使得错误处理更加精确：

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)
        }
    }()
    // 尝试使用不支持的哈希算法
    err := f.ProtectSheet("Sheet1", &excelize.FormatSheetProtection{
        AlgorithmName: "UNSUPPORTED_ALGORITHM",
        Password:      "password",
    })
    if err != nil {
        if err == excelize.ErrUnsupportedHashAlgorithm {
            fmt.Println("不支持的哈希算法")
        } else {
            fmt.Printf("其他错误: %v\n", err)
        }
    }
}

7. 流式读取性能优化

对于大型Excel文件，流式读取现在有更好的内存表现：

package main

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

func main() {
    f, err := excelize.OpenFile("large_file.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 使用流式读取器
    rows, err := f.Rows("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer rows.Close()
    // 逐行读取
    for rows.Next() {
        row, err := rows.Columns()
        if err != nil {
            fmt.Println(err)
            break
        }
        // 处理行数据
        fmt.Println(row)
    }
}

这些示例展示了Excelize 2.6.0版本中一些重要新功能的实际应用。版本更新中的性能改进、错误修复和兼容性增强使得这个库在处理Excel文档时更加可靠和高效。特别是流式读取的内存优化，对于处理大型数据文件具有重要意义。