Golang Excelize 2.0.1 版本发布

Excelize 2.0.1 版本的发布确实带来了许多实用的新功能和重要的错误修复，这对于处理 Excel 文件的 Go 开发者来说是一个重大更新。以下是一些关键特性的示例代码，帮助大家快速上手这些新功能。

设置页眉和页脚

新函数 SetHeaderFooter() 允许您为 Excel 工作表设置自定义页眉和页脚。这在生成报告时特别有用。

package main

import "github.com/360EntSecGroup-Skylar/excelize/v2"

func main() {
    f := excelize.NewFile()
    // 设置页眉和页脚
    err := f.SetHeaderFooter("Sheet1", &excelize.HeaderFooterOptions{
        DifferentFirst:   false,
        DifferentOddEven: false,
        OddHeader:        "&CHeader",
        OddFooter:        "&CFooter",
    })
    if err != nil {
        panic(err)
    }
    // 保存文件
    if err := f.SaveAs("header_footer.xlsx"); err != nil {
        panic(err)
    }
}

按列设置样式

SetColStyle() 函数使得按列应用样式变得简单，例如设置整列的字体或背景色。

package main

import "github.com/360EntSecGroup-Skylar/excelize/v2"

func main() {
    f := excelize.NewFile()
    // 创建样式
    style, err := f.NewStyle(`{"font":{"bold":true,"color":"#FF0000"}}`)
    if err != nil {
        panic(err)
    }
    // 将样式应用到 A 列
    err = f.SetColStyle("Sheet1", "A", style)
    if err != nil {
        panic(err)
    }
    // 保存文件
    if err := f.SaveAs("col_style.xlsx"); err != nil {
        panic(err)
    }
}

更改默认字体

使用 SetDefaultFont() 可以全局设置工作簿的默认字体，这在统一文档风格时非常方便。

package main

import "github.com/360EntSecGroup-Skylar/excelize/v2"

func main() {
    f := excelize.NewFile()
    // 设置默认字体为 Arial
    f.SetDefaultFont("Arial")
    // 获取当前默认字体
    font := f.GetDefaultFont()
    println("Default font:", font) // 输出: Default font: Arial
    // 保存文件
    if err := f.SaveAs("default_font.xlsx"); err != nil {
        panic(err)
    }
}

设置和获取文档属性

新函数 SetDocProps() 和 GetDocProps() 允许管理文档属性，如标题、主题和作者。

package main

import "github.com/360EntSecGroup-Skylar/excelize/v2"

func main() {
    f := excelize.NewFile()
    // 设置文档属性
    err := f.SetDocProps(&excelize.DocProperties{
        Title:   "My Document",
        Subject: "Excelize Example",
        Creator: "Go Developer",
    })
    if err != nil {
        panic(err)
    }
    // 获取文档属性
    props, err := f.GetDocProps()
    if err != nil {
        panic(err)
    }
    println("Title:", props.Title) // 输出: Title: My Document
    // 保存文件
    if err := f.SaveAs("doc_props.xlsx"); err != nil {
        panic(err)
    }
}

添加新图表类型

AddChart() 现在支持更多图表类型，例如 3D 曲面图或气泡图。以下是一个添加柱形图的示例。

package main

import "github.com/360EntSecGroup-Skylar/excelize/v2"

func main() {
    f := excelize.NewFile()
    // 添加一些数据
    f.SetCellValue("Sheet1", "A1", "Item")
    f.SetCellValue("Sheet1", "A2", "Apple")
    f.SetCellValue("Sheet1", "A3", "Orange")
    f.SetCellValue("Sheet1", "B1", "Sales")
    f.SetCellValue("Sheet1", "B2", 50)
    f.SetCellValue("Sheet1", "B3", 30)
    // 定义图表
    err := f.AddChart("Sheet1", "D1", `{
        "type": "col",
        "series": [
            {"name":"Sheet1!$A$1","categories":"Sheet1!$A$2:$A$3","values":"Sheet1!$B$2:$B$3"}
        ],
        "title": {"name": "Sales Chart"}
    }`)
    if err != nil {
        panic(err)
    }
    // 保存文件
    if err := f.SaveAs("chart.xlsx"); err != nil {
        panic(err)
    }
}

设置和获取定义名称

SetDefinedName() 和 GetDefinedName() 函数支持在 Excel 中管理命名范围，便于公式引用。

package main

import "github.com/360EntSecGroup-Skylar/excelize/v2"

func main() {
    f := excelize.NewFile()
    // 设置定义名称
    err := f.SetDefinedName(&excelize.DefinedName{
        Name:     "SalesRange",
        RefersTo: "Sheet1!$A$1:$B$3",
        Comment:  "Sales data range",
    })
    if err != nil {
        panic(err)
    }
    // 获取定义名称
    definedNames := f.GetDefinedName()
    for _, dn := range definedNames {
        println("Name:", dn.Name, "RefersTo:", dn.RefersTo)
    }
    // 保存文件
    if err := f.SaveAs("defined_name.xlsx"); err != nil {
        panic(err)
    }
}

这些示例展示了如何利用 Excelize 2.0.1 的新功能来增强 Excel 文件处理能力。错误修复如数据验证公式的改进和文件损坏问题的解决，进一步提升了库的稳定性和兼容性。建议开发者升级到此版本以获得最佳体验。