office

极简、高效的 Go Excel 处理库，基于 excelize 构建，符合 @go 设计哲学。

特性

• 统一 API: 提供极简的 Open, Save, Get, Set 等操作。
• 自动对齐: 自动处理工作表的创建和索引。
• 对象映射: 支持将 []map[string]any 直接写入 Excel 或从 Excel 读取。
• 高性能: 尽量减少内存分配和冗余操作。

快速开始

安装

go get apigo.cc/go/office

基础用法

import "apigo.cc/go/office"

// 创建并写入
xls := office.New()
table := [][]any{
    {"Name", "Age"},
    {"Alice", 25},
    {"Bob", 30},
}
xls.Set("Sheet1", table, "A1", "")
xls.Save("example.xlsx")

// 读取
xls2, _ := office.Open("example.xlsx")
data, _ := xls2.Get("Sheet1", "A1", "")

对象列表操作

data := []map[string]any{
    {"Name": "Alice", "Age": 25},
    {"Name": "Bob", "Age": 30},
}
xls.SetData("Users", data, "A1", "")

API 参考

核心函数

• New() *Excel: 创建新的 Excel 对象。
• Open(filename string, password ...string) (*Excel, error): 打开现有文件。

Excel 方法

• Save(filename ...string) error: 保存文件。
• Bytes() ([]byte, error): 获取字节切片。
• Set(sheetName string, table [][]any, start, end string) error: 写入二维数据。
• Get(sheetName string, start, end string) ([][]any, error): 读取二维数据。
• SetData(sheetName string, data []map[string]any, start, end string) error: 写入对象列表。
• GetData(sheetName string, start, end string) ([]map[string]any, error): 读取对象列表。
• Sheets() []string: 获取工作表列表。
• RemoveSheet(sheetName string) error: 删除工作表。

工具函数

• MakeCellID(col, row int) string: 生成单元格 ID (如 "A1")。
• ParseCellID(cell string) (col, row int): 解析单元格 ID。
• MakeColID(col int) string: 生成列 ID (如 "A")。