Как загрузить электронную таблицу в Python

Это руководство показывает, как загрузить файлы электронных таблиц XLSX и CSV в Python с помощью Workbook, получить доступ к листам с помощью get_worksheet() и считывать значения ячеек через сетку Worksheet.cells. Библиотека работает в чистом Python без Microsoft Office или нативных расширений.

Пошаговое руководство

pip install aspose-cells-foss

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

from aspose.cells_foss import Workbook

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")
print("Loaded:", wb.file_path)

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")

# By index
ws = wb.get_worksheet(0)

# By name
ws_named = wb.get_worksheet("Summary")

print(f"Worksheets: {len(wb.worksheets)}")
print(f"First sheet: {ws.name}")

from aspose.cells_foss import Workbook

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

# Read individual cells
product = cells.cell(0, 0).value   # row 0, col 0 (A1)
revenue = cells.cell(0, 1).value   # row 0, col 1 (B1)

print(f"Product: {product}")
print(f"Revenue: {revenue}")

# Safe read with empty check
cell = cells.cell(1, 0)
if not cell.is_empty():
    print(f"A2: {cell.value}")

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")
ws = wb.get_worksheet(0)

for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

Распространённые проблемы и решения

FileNotFoundError при загрузке Проверьте, что путь правильный и файл существует. Используйте pathlib.Path для переносимых путей: Workbook(str(Path("data") / "report.xlsx")).

Cell.value returns None Ячейка пуста или находится за пределами диапазона. Используйте Cell.is_empty() для проверки перед чтением value. Координаты за пределами диапазона не вызывают ошибок — они возвращают пустые ячейки.

Файл, защищённый паролем, вызывает ошибку Передайте пароль в качестве второго аргумента: Workbook("protected.xlsx", "secret").

Загрузка происходит только первого листа при чтении CSV Файлы CSV содержат один лист. Используйте Workbook.load_csv(file_path) на существующем Workbook экземпляре, если вам нужно импортировать данные CSV в конкретную позицию листа, а не читать через Workbook() конструктор напрямую.

Имя листа не найдено с get_worksheet(name) Имена листов чувствительны к регистру. Выведите ws.name для каждого индекса в wb.worksheets чтобы подтвердить точное имя перед вызовом get_worksheet("Name").

Часто задаваемые вопросы

Работает ли это на Linux и macOS?

Да. aspose-cells-foss — это чистый Python и работает на Windows, macOS, Linux и в Docker-контейнерах без каких-либо нативных расширений или системных зависимостей.

Какие форматы файлов я могу загрузить?

Конструктор Workbook() поддерживает файлы XLSX. Файлы CSV можно загрузить, передав путь .csv или вызвав Workbook.load_csv(file_path) у экземпляра Workbook.

Как найти последнюю строку с данными?

Итерируйте с помощью Cells.iter_rows() и останавливайтесь, когда все значения в строке равны None, либо используйте Cell.is_empty() на граничных ячейках, чтобы определить, где заканчиваются данные.

Могу ли я открыть книгу без предварительного знания её формата?

Передайте путь к файлу в Workbook(file_path). Библиотека определяет формат по расширению файла и заголовкам. Если расширение отсутствует или неоднозначно, используйте явный параметр формата сохранения/загрузки.

Как прочитать ячейку по её буквенной адресе, например “B3”?

Используйте нулевые индексы для строк и столбцов: B3 — это строка 2, столбец 1. Преобразуйте буквенные адреса с помощью ord(col_letter) - ord("A") для односимвольных столбцов. Например, B равно ord("B") - ord("A") == 1, поэтому cells.cell(2, 1) соответствует B3.

См. также:

• Как начать работу с Aspose.Cells FOSS for Python
• Как сохранять электронные таблицы в Python
• Как загружать электронные таблицы в Python
• Документация по началу работы
• API Reference
• Aspose.Cells for Python — Enterprise Knowledge Base