Excelize v2.10.1

Lançado em: 25 de fevereiro de 2026
GitHub Release: https://github.com/xuri/excelize/releases/tag/v2.10.1

Notas de versão

As mudanças mais notáveis nesta versão são:

Quebrando mudanças

Removidas três variáveis de erro exportadas: ErrStreamSetColStyle, ErrStreamSetColWidth e ErrStreamSetPanes.

Recursos notáveis

Adicionado o tipo de dados ChartDataPoint
Adicionado o campo DataPoint a ChartSeries
Adicionados os campos DropLines e HighLowLines a ChartAxis
Adicionado o campo Name a GraphicOptions
Adicionadas duas constantes: MaxGraphicAltTextLength e MaxGraphicNameLength
Adicionadas 7 variáveis de erro exportadas: ErrFillType, ErrFillGradientColor, ErrFillGradientShading, ErrFillPatternColor, ErrFillPattern, ErrMaxGraphicAltTextLength e ErrMaxGraphicNameLength
Adicionada a função exportada GetHyperLinkCells para recuperar células com hiperlinks, problema relacionado #1607
Adicionada a função exportada GetSheetProtection para recuperar as configurações de proteção da planilha
A função AddComment agora retorna um erro ao adicionar um comentário a uma célula que já possui um
Adicionado suporte para inserção de imagens ICO, problema relacionado #2234
A função CalcCellValue agora suporta duas funções de fórmula: SORTBY e UNIQUE
As funções AddChart e AddChartSheet agora suportam a definição de cores de pontos de dados para gráficos de rosca, pizza e pizza 3D, problema relacionado #1904
A função AddChart agora suporta a configuração de famílias de fontes para fontes do leste asiático e scripts complexos
A função AddChart agora suporta linhas de projeção e linhas de máximo-mínimo para gráficos de área e de linhas
A função GetPictures agora pode retornar propriedades de formatação parciais, problema relacionado #2157
Adicionada a função SetColVisible ao streaming writer para definir a visibilidade das colunas, problema relacionado #2075
Adicionada a função SetColOutlineLevel ao streaming writer para agrupar colunas, problema relacionado #2212
As funções AddShape e AddSlicer agora suportam posicionamento de ancoragem em uma célula para formas e segmentações de dados
A função GetSlicers agora suporta a recuperação de segmentações de dados com posicionamento de ancoragem em uma célula
As funções SetConditionalFormat, GetConditionalFormats e UnsetConditionalFormat agora suportam os formatos condicionais com conjuntos de ícones de 3 triângulos, 3 estrelas e 5 caixas, problema relacionado #2038
A função UnsetConditionalFormat agora suporta a exclusão de uma regra de formato condicional ou validação de dados para uma célula específica dentro de um intervalo de células
As funções AddPicture e AddPictureFromBytes agora suportam a definição do nome da imagem
As funções AddChart e AddShape agora suportam a definição de nomes e texto alternativo para gráficos e formas
A função AddSlicer agora suporta a definição de texto alternativo para segmentações de dados
Adicionada validação para nomes gráficos e comprimento do texto alternativo; retorna um erro quando o comprimento excede o limite
Adicionada verificação e truncamento de comprimento compatível com UTF-16

Melhore a compatibilidade

Removidas linhas vazias ao salvar, reduzindo o tamanho do arquivo da pasta de trabalho gerada

Correções de bugs

Corrigida uma regressão v2.10.0 onde as funções GetCellValue e GetRows retornavam índices de strings compartilhadas para strings vazias, problema resolvido #2240
Corrigido GetPivotTables que causava panic ao recuperar tabelas dinâmicas em alguns casos
Corrigido um panic ao ler valores de células com determinados códigos de formato numérico contendo nomes de meses chineses, problema resolvido #2224
Corrigido um panic ao abrir pastas de trabalho criptografadas em alguns casos, problema resolvido #2237
Corrigidos estilos de coluna ausentes ao usar a função SetRow do streaming writer
Corrigido GetPictures que não retornava algumas imagens de células
Corrigida a corrupção da pasta de trabalho causada por overflow do índice de cor do tema claro
Corrigido DeleteDataValidation que atualizava incorretamente os intervalos de células de validação de dados com referências de células não ordenadas
Corrigido SetConditionalFormat que gerava pastas de trabalho corrompidas ao definir regras de formatação condicional de período de tempo
Corrigido CalcCellValue que falhava ao resolver referências em alguns casos removendo aspas simples dos nomes das planilhas
Corrigido NewStyle que criava estilos duplicados ao usar a fonte ou preenchimento padrão, problema resolvido #2254

Otimização de performance

Otimizado CalcCellValue adicionando um cache de cálculo e limitando o processamento aos intervalos de dados reais, problemas resolvidos #2057 e #2223
Otimizada a avaliação de fórmulas CalcCellValue para VLOOKUP, reduzindo o uso de memória e o tempo de execução em cerca de 50%, problema resolvido #2139
Otimizado GetMergeCells acelerando as verificações de sobreposição para intervalos de células mescladas e reduzindo o uso de memória, problema resolvido #2226
Otimizada a aplicação de códigos de formato numérico convertendo usando fórmulas de recorrência de frações contínuas

Diversas

O módulo de dependências foi atualizado
Testes unitários e godoc atualizados
Site de documentação com multilíngue: árabe, alemão, inglês, espanhol, francês, italiano, japonês, coreano, português, russo, chinês simplificado e chinês tradicional, que foi atualizado
excelize-wasm Atualização do pacote NPM para suporte a WebAssembly / JavaScript
excelize Atualização do pacote PyPI para Python
ExcelizeCs Atualização do pacote NuGet .Net para C#

Obrigado

Obrigado a todos os colaboradores do Excelize. Abaixo está uma lista de contribuidores que possuem contribuições de código nesta versão:

@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)