Excelize v2.10.1

Версия выпущена: 25 февраля 2026 г.
GitHub Release: https://github.com/xuri/excelize/releases/tag/v2.10.1

Примечания к выпуску

Наиболее заметные изменения в этом выпуске:

Совместимость

Удалены три экспортируемые переменные ошибок: ErrStreamSetColStyle, ErrStreamSetColWidth и ErrStreamSetPanes.

Примечательные особенности

Добавлен тип данных ChartDataPoint
В ChartSeries добавлено поле DataPoint
В ChartAxis добавлены поля DropLines и HighLowLines
В GraphicOptions добавлено поле Name
Добавлены две константы: MaxGraphicAltTextLength и MaxGraphicNameLength
Добавлены 7 экспортируемых переменных ошибок: ErrFillType, ErrFillGradientColor, ErrFillGradientShading, ErrFillPatternColor, ErrFillPattern, ErrMaxGraphicAltTextLength и ErrMaxGraphicNameLength
Добавлена экспортируемая функция GetHyperLinkCells для получения ячеек с гиперссылками, связанная проблема #1607
Добавлена экспортируемая функция GetSheetProtection для получения настроек защиты листа
Функция AddComment теперь возвращает ошибку при попытке добавить комментарий в ячейку, которая уже его содержит
Добавлена поддержка вставки изображений формата ICO, связанная проблема #2234
Функция CalcCellValue теперь поддерживает формулы SORTBY и UNIQUE
Функции AddChart и AddChartSheet теперь поддерживают установку цвета точек данных для диаграмм doughnut, pie и 3D pie, связанная проблема #1904
Функция AddChart теперь поддерживает настройку семейств шрифтов для восточноазиатских и сложных письменных систем
Функция AddChart теперь поддерживает линии спада и линии максимум-минимум для областных и линейных диаграмм
Функция GetPictures теперь может возвращать частичные свойства форматирования, связанная проблема #2157
В потоковый писатель добавлена функция SetColVisible для управления видимостью столбцов, связанная проблема #2075
В потоковый писатель добавлена функция SetColOutlineLevel для группировки столбцов, связанная проблема #2212
Функции AddShape и AddSlicer теперь поддерживают позиционирование с привязкой к одной ячейке
Функция GetSlicers теперь поддерживает получение срезов с привязкой к одной ячейке
Функции SetConditionalFormat, GetConditionalFormats и UnsetConditionalFormat теперь поддерживают наборы значков, 3 треугольника, 3 звезды и 5 квадратов, для условного форматирования, связанная проблема #2038
Функция UnsetConditionalFormat теперь поддерживает удаление правила условного форматирования или проверки данных для конкретной ячейки в диапазоне
Функции AddPicture и AddPictureFromBytes теперь поддерживают установку имени изображения
Функции AddChart и AddShape теперь поддерживают установку имени и альтернативного текста для диаграмм и фигур
Функция AddSlicer теперь поддерживает установку альтернативного текста для срезов
Добавлена проверка длины имени графических объектов и альтернативного текста, при превышении лимита возвращается ошибка
Добавлена проверка длины и обрезка строк с учётом UTF-16

Улучшение совместимости

Удаляются пустые строки при сохранении, что уменьшает размер создаваемого файла книги

Исправление ошибок

Исправлена регрессия v2.10.0, при которой функции GetCellValue и GetRows возвращали индексы shared strings для пустых строк, решено в #2240
Исправлена паника в GetPivotTables при получении сводных таблиц в некоторых случаях
Исправлена паника при чтении значений ячеек с определёнными форматами чисел, содержащими китайские названия месяцев, решено в #2224
Исправлена паника при открытии зашифрованных книг в некоторых случаях, решено в #2237
Исправлено отсутствие стилей столбцов при использовании потоковой функции SetRow
Исправлена ошибка, из-за которой GetPictures не возвращала некоторые изображения ячеек
Исправлено повреждение книги из-за переполнения индекса цвета светлой темы
Исправлено некорректное обновление диапазонов проверки данных в DeleteDataValidation при неупорядоченных ссылках на ячейки
Исправлено создание повреждённых книг функцией SetConditionalFormat при установке правил условного форматирования по временным периодам
Исправлено некорректное разрешение ссылок в CalcCellValue в некоторых случаях путём удаления одинарных кавычек из имён листов
Исправлено создание дублирующихся стилей функцией NewStyle при использовании шрифта или заливки по умолчанию, решено в #2254

Оптимизация производительности

Оптимизирована функция CalcCellValue за счёт добавления кэша вычислений и ограничения обработки фактическими диапазонами данных, решены задачи #2057 и #2223
Оптимизировано вычисление формулы VLOOKUP в CalcCellValue, что сократило потребление памяти и время выполнения примерно на 50%, решено в #2139
Оптимизирована функция GetMergeCells за счёт ускорения проверки пересечений диапазонов объединённых ячеек и снижения потребления памяти, решено в #2226
Оптимизировано применение числовых форматов путём преобразования с использованием рекуррентных формул непрерывных дробей

Другие

Обновлен модуль зависимостей
Унитарные тесты и godoc обновлены
Сайт документации с многоязычностью: арабский, немецкий, английский, испанский, французский, итальянском, японский, корейский, португальский, русский, китайский упрощенный и китайский традиционный, который был обновлен.
excelize-wasm Обновление выпуска пакета NPM для поддержки WebAssembly / JavaScript
excelize Обновление выпуска пакета PyPI для Python
ExcelizeCs Обновление выпуска пакета NuGet .Net для C#

Спасибо

Спасибо всем участникам Excelize. Ниже приведен список участников, внесших свой код в эту версию:

@pjh591029530 (Simmons25)
@Sang-Hyuk (SangHyuk)
@wangacc
@kenny-not-dead (Roman Sergeev)
@pegasscience-cyber
@jesusfelix951-lang
@felixdevelopper-hue
@shcabin
@radam9
@sqdtss
@IvanHristov98 (Ivan Hristov)
@yasarluo (Yasar Luo)
@DengY11 (Yi Deng)
@Kingson4Wu (Kingson4Wu)
@zhuzhengyang (Zhu Zhengyang)
@schbook
@rhinewg
@jpoz (James Pozdena)
@sides-flow (Sides)
@t4traw (Tatsuro Moriyama)
@ijustyce (杨春)
@d9c4
@imirkin (Ilia Mirkin)
@atmngw (Atsuki)
@Flashcqxg
@olivere (Oliver Eilhard)
@susautw (Su, Rin)
@ohauer (Olli Hauer)
@yan00353-0729

v2.10.1 (2026-02-25)