Встановіть `portionFormat.setLatinFont()`:

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

Крок за кроком посібник

Крок 1: Налаштування пакету

Інсталювати пакет Aspose.Font FOSS з PyPI за допомогою нижче наведеної команди pip:

pip install aspose-cells-foss>=26.3.1

Перевірка установки шляхом імпорту Workbook і друкування повідомлення про підтвердження:

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

Крок 2: Необхідні класи імпорту

Імпорт Workbook клас з aspose.cells_foss для доступу до API завантаження таблиці:

from aspose.cells_foss import Workbook

Крок 3: Завантажити робочий лист з файлу

Передати ряд доріг файлу на: Workbook() завантажити існуючу таблицю. Конструктор приймає факультативний password аргумент для захищених файлів:

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


---

### Крок 4: Доступ до таблиці

Використання `get_worksheet()` з цілим індексом (0-на основі) або стрункою назви листа. Використовуйте `worksheets` властивість, щоб побачити скільки аркушів містить робоча книжка:

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}")

<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“Скопіювати код”

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Крок 5: Читання значення клітин

Доступні клітини через Worksheet.cells власність. використання Cells.cell(row, col) до відшукати Cell Читайте дані з Офіційний номер: Cell.value власність. використання Cell.is_empty() безпечно пропускати порожні ячейки:

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}")


---

### Крок 6: Ітерація всіх рядків

Використання `Cells.iter_rows()` прогулятися по всіх рядах, не знаючи розмірів. Pass `values_only=True` отримувати прості значення Python замість `Cell` об'єкти:

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)

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Загальні проблеми та рішення

FileNotFoundError при завантаженні Перевірте, що шлях правильний і файл існує. Використовуйте pathlib.Path для переносних пристроїв маршрути: Workbook(str(Path("data") / "report.xlsx")).

Cell.value повернення 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. контейнери без будь-яких нативних розширень або системних залежностей.

Імпорти підшляхів вимагають експорту пакету Node.js 12.7+. У TypeScript встановіть правильне розв’язання модулів:?

У. Workbook() Конструктор підтримує файли XLSX. Файли CSV можуть бути завантажені, передаючи .csv шлях або зателефонувати Workbook.load_csv(file_path) на Workbook Наприклад.

Як я знайду останній ряд з даними?

Ітерація з Cells.iter_rows() і зупиняється, коли всі значення ряду є: None, або використання Cell.is_empty() на межі ячейки, щоб виявити, де закінчуються дані.

Чи можу я відкрити робочий кнопка, не знаючи попередньо його формат?

Передати шлях файлу до: Workbook(file_path). Бібліотека виводить формат з Якщо розширення відсутнє або неоднозначне, використовуйте Визначений варіант формати збереження/завантаження.

Як я читаю клітину за адресою, наприклад “Б3”?

Використовуйте ціле числа рядків і стовпців на основі нуля: B3 - це ряд 2, колона 1. Переведіть адреси листів. з: ord(col_letter) - ord("A") для колонок з однією буквою. Наприклад, B є: ord("B") - ord("A") == 1, так що cells.cell(2, 1) Карти до B3.