Быстрый старт с Go Excelize

Введение в Excelize

Excelize - это базовая библиотека для работы с документами Office Excel, написанная на языке Go, основанная на международных стандартах ECMA-376 и ISO/IEC 29500. Она может использоваться для чтения и записи электронных таблиц, созданных в Microsoft Excel™ 2007 и выше, поддерживая различные форматы документов, такие как XLAM / XLSM / XLSX / XLTM / XLTX. Она отлично совместима с документами, содержащими стили, изображения (таблицы), сводные таблицы, фильтры и другие сложные компоненты, а также предоставляет API потокового чтения и записи для обработки книг с большим объемом данных. Ее можно применять в различных отчетных платформах, облачных вычислениях, краевых вычислениях и других системах. Для использования этой библиотеки требуется версия языка Go 1.16 или выше.

Установка

В таблице ниже указаны минимальные требования базовой библиотеки Excelize для различных версий языка Go:

Использование последней версии Excelize требует язык Go версии 1.16 или выше. Обратите внимание, что в версии Go 1.21.0 имеются несовместимые изменения, из-за которых базовая библиотека Excelize работает неправильно на этой версии. Если вы используете Go 1.21.x, обновите до версии 1.21.1 или выше.

• Команда установки

go get github.com/xuri/excelize

• Если вы используете Модули Go для управления пакетами, используйте следующую команду для установки последней версии.

go get github.com/xuri/excelize/v2

Обновление

• Команда обновления

go get -u github.com/xuri/excelize/v2

Создание документов Excel

Ниже приведен простой пример создания документа Excel:

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, err := f.NewSheet("Sheet2")
    if err != nil {
        fmt.Println(err)
        return
    }
    // Установка значений ячеек
    f.SetCellValue("Sheet2", "A2", "Привет, мир.")
    f.SetCellValue("Sheet1", "B2", 100)
    // Установка листа по умолчанию в книге
    f.SetActiveSheet(index)
    // Сохранение файла в указанный путь
    if err := f.SaveAs("Книга1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Чтение документов Excel

Ниже приведен пример чтения документов Excel:

package main

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

func main() {
    f, err := excelize.OpenFile("Книга1.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // Получение значения указанной ячейки на листе
    cell, err := f.GetCellValue("Sheet1", "B2")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(cell)
    // Получение всех ячеек на листе Sheet1
    rows, err := f.GetRows("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
    }
    for _, row := range rows {
        for _, colCell := range row {
            fmt.Print(colCell, "\t")
        }
        fmt.Println()
    }
}

Создание диаграмм в документах Excel

Создание диаграмм в Excelize очень просто и требует всего нескольких строк кода. Вы можете строить диаграммы на основе существующих данных на листе или добавлять данные на лист, а затем создавать диаграммы.

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)
        }
    }()
    for idx, row := range [][]interface{}{
        {nil, "Яблоко", "Апельсин", "Груша"}, {"Маленький", 2, 3, 3},
        {"Обычный", 5, 2, 4}, {"Большой", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        f.SetSheetRow("Sheet1", cell, &row)
    }
    if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
        Type: excelize.Col3DClustered,
        Series: []excelize.ChartSeries{
            {
                Name:       "Sheet1!$A$2",
                Categories: "Sheet1!$B$1:$D$1",
                Values:     "Sheet1!$B$2:$D$2",
            },
            {
                Name:       "Sheet1!$A$3",
                Categories: "Sheet1!$B$1:$D$1",
                Values:     "Sheet1!$B$3:$D$3",
            },
            {
                Name:       "Sheet1!$A$4",
                Categories: "Sheet1!$B$1:$D$1",
                Values:     "Sheet1!$B$4:$D$4",
            }},
        Title: []excelize.RichTextRun{
            {
                Text: "Диаграмма 3D группы столбцов фруктов",
            },
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    // Сохранение файла по указанному пути
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Вставка изображений в документ Excel

package main

import (
    "fmt"
    _ "image/gif"
    _ "image/jpeg"
    _ "image/png"

    "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)
        }
    }()
    // Вставка изображения
    if err := f.AddPicture("Sheet1", "A2", "image.png", nil); err != nil {
        fmt.Println(err)
        return
    }
    // Вставка изображения на лист и установка масштаба изображения
    if err := f.AddPicture("Sheet1", "D2", "image.jpg",
        &excelize.GraphicOptions{ScaleX: 0.5, ScaleY: 0.5}); err != nil {
        fmt.Println(err)
        return
    }
    // Вставка изображения на лист и установка свойств печати изображения
    enable, disable := true, false
    if err := f.AddPicture("Sheet1", "H2", "image.gif",
        &excelize.GraphicOptions{
            PrintObject:     &enable,
            LockAspectRatio: false,
            OffsetX:         15,
            OffsetY:         10,
            Locked:          &disable,
        }); err != nil {
        fmt.Println(err)
        return
    }
    // Сохранение файла
    if err = f.Save(); err != nil {
        fmt.Println(err)
    }
}