Como começar com Aspose.Cells FOSS para Python

aspose-cells-foss Python é uma biblioteca gratuita e licenciada pelo MIT para criação, leitura e Conversão de arquivos de folha de largura — não Microsoft Office necessário, não extensões nativas, puro Python do PIPI.

Guia Passo a Passo

Etapa 1: Instalar o Pacote

Problemas de Memória e Desempenho:

pip install aspose-cells-foss>=26.3.1

Verifique a instalação:

from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")

Passo 2: Importar as classes necessárias

from aspose.cells_foss import Workbook, SaveFormat

Passo 3: Crie um livro de trabalho e escreva dados

Usando Workbook() para criar um novo livro de trabalho. adicionar uma folha de texto com add_worksheet(),Então, então Acesso à rede celular através da cells Propriedade e uso Cells.cell(row, col) Para obter a Cell.- Defina valores com Cell.put_value():

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook()
ws = wb.add_worksheet("Sales")

cells = ws.cells
cells.cell(1, 1).put_value("Product")
cells.cell(1, 2).put_value("Revenue")
cells.cell(2, 1).put_value("Widget A")
cells.cell(2, 2).put_value(12500)
cells.cell(3, 1).put_value("Widget B")
cells.cell(3, 2).put_value(8750)

wb.save("sales.xlsx", SaveFormat.XLSX)
print("sales.xlsx written.")

Passo 4: Leia o livro de trabalho de volta

Carregar um arquivo existente passando o caminho do arquivos para Workbook(file_path).Usando get_worksheet() por índice ou nome, depois leia os valores da célula através do value Propriedade de propriedade:

from aspose.cells_foss import Workbook

wb = Workbook("sales.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells

print(f"A1: {cells.cell(1, 1).value}")
print(f"B2: {cells.cell(2, 2).value}")

Etapa 3: Salve no Formato de Destino

Workbook.save() Suporte a vários formatos através de SaveFormat.Usando SaveFormat.CSV Para A produção separada e SaveFormat.MARKDOWN Para tabelas de Markdown:

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook("sales.xlsx")
wb.save("sales.csv", SaveFormat.CSV)
wb.save("sales.md", SaveFormat.MARKDOWN)
print("CSV and Markdown exports written.")

Problemas Comuns e Soluções

ModuleNotFoundError: No module named 'aspose' Instale o pacote no ambiente virtual ativo: pip install aspose-cells-foss. Confirmando com pip show aspose-cells-foss.

FileNotFoundError Quando carregar um livro de trabalho Usando pathlib.Path Para construir caminhos portáteis: Workbook(str(Path("data") / "file.xlsx")).

Valor celular retorna None Depois da leitura A célula está vazia ou fora de alcance.Utilização Cell.is_empty() Verificar antes de ler value.

O resultado CSV contém apenas a primeira folha save() com SaveFormat.CSV Exporta apenas a folha de trabalho activa.Utilização set_active_worksheet() Selecione a folha que você deseja exportar antes de economizar.

O arquivo XLSX não é aberto pelo Excel. Assegure-se de que você passa SaveFormat.XLSX sem ele, o formato é derivado do A extensão do arquivo; se o caminho não tiver .xlsx A extensão da produção pode não ser válida.

Perguntas Frequentes

O aspose-cells-foss requer o Microsoft Office?

A biblioteca lê e escreve arquivos de folha nativa em Python puro sem qualquer dependência do Microsoft Office, COM automation ou Windows API.

Quais versões de Python são suportadas?

Python 3.7 ou posterior. o pacote funciona em contêineres Windows, macOS, Linux e Docker.

A biblioteca é livre para uso comercial?

É lançado sob a Licença MIT. Você pode usá-lo, modificar e redistribuir para qualquer finalidade, incluindo aplicações comerciais.

Como eu itero sobre todas as células em uma folha?

Usando Cells.iter_rows() Para iterar a linha por linha:

from aspose.cells_foss import Workbook

wb = Workbook("data.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

Quais formatos posso salvar?

SaveFormat Apoio XLSX, CSV, TSV, MARKDOWN,e JSON.Usando SaveFormat.from_extension(file_path) para detectar o formato automaticamente a partir de um caminho de arquivo.