Как начать с Aspose.Cells FOSS для Python
aspose-cells-foss Python - это бесплатная библиотека, лицензируемая MIT для создания, чтения и конвертирование файлов с шифром — нет требований Microsoft Office, нет коренных расширения, чистый Python из PyPI.
Пошаговое руководство
Шаг 1: Установите пакет
Настройка с ПИП с помощью:
pip install aspose-cells-foss>=26.3.1Проверьте установку:
from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")Шаг 2: Ввоз необходимых классов
from aspose.cells_foss import Workbook, SaveFormatШаг 3: Создайте рабочую книгу и напишите данные
Использование Workbook() создание новой рабочей книги.Добавить рабочую книжку с add_worksheet(),И тогда доступа к сети через cells имущество и использование Cells.cell(row, col) Чтобы получить A Cell.Вспомните ценности с 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.")Шаг 4: Прочитайте рабочую книгу назад
Загрузить существующий файл, переходя по файловой дороге к Workbook(file_path).Используйте get_worksheet() по индексу или названию, затем читать ценности клеток через value Собственность →:
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}")Шаг 3: Сохраните в целевой формат
Workbook.save() Поддерживает множество форматов через SaveFormat.Используйте SaveFormat.CSV Для Отдельный выход и SaveFormat.MARKDOWN Для таблиц 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.")Общие проблемы и решения
ModuleNotFoundError: No module named 'aspose' Инсталляция в активной виртуальной среде: pip install aspose-cells-foss. подтверждает с pip show aspose-cells-foss.
FileNotFoundError Когда загружается рабочая книга Использование pathlib.Path Для создания портативных путей: Workbook(str(Path("data") / "file.xlsx")).
Цены клеток возвращаются None После чтения Клетка пуста или не проходит.Смотрите Cell.is_empty() Проверьте перед чтением value.
Выход CSV содержит только первую листье. save() С SaveFormat.CSV Выпускает только активный рабочий лист. используется set_active_worksheet() Выберите лист, который вы хотите экспортировать перед сбережением.
Файл XLSX не открывается Excel Убедитесь, что вы пройдете SaveFormat.XLSX без него форма изводится из Долгое расширение файла; если маршрут не имеет .xlsx Продолжение выхода может не быть действительным.
Часто задаваемые вопросы
Нужен ли aspose-cells-foss для Microsoft Office?
Библиотека читает и пишет файлы с шифровами листовками в чистом Python без зависимости от Microsoft Office, COM автоматизации или Windows API.
Какие версии Python поддерживаются?
Python 3.7 или более поздней. пакет работает на контейнерах Windows, macOS, Linux и Docker.
Свободно ли библиотека для коммерческого использования?
Вы можете использовать, модифицировать и перераспространять его для любых целей, включая коммерческие приложения.
Как я итерю над всеми клетками в одной листе?
Использование Cells.iter_rows() Для перевода по строку:
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)Какие формати я могу сохранить?
SaveFormat Поддержка XLSX, CSV, TSV, MARKDOWN,и JSON.Используйте SaveFormat.from_extension(file_path) для автоматического обнаружения формата с файлового пути.