Cara Mengunggah Spreadsheet di Python

Panduan ini menunjukkan cara memuat file spreadsheet XLSX dan CSV di Python menggunakan Workbook, akses lembar kerja dengan get_worksheet(), dan membaca nilai sel melalui Worksheet.cells Perpustakaan berjalan dalam Python murni tanpa Microsoft Office atau ekstensi asli.

Panduan Langkah-Langkah

Langkah 1: Instalasi paket

Instal paket Aspose.Font FOSS dari PyPI menggunakan perintah pip di bawah ini:

pip install aspose-cells-foss>=26.3.1

Memverifikasi instalasi dengan mengimpor Workbook dan mencetak pesan konfirmasi:

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

Langkah 2: Import Kelas yang Diperlukan

Membawa barang-barang yang ada di dalam. Workbook kelas dari aspose.cells_foss untuk mengakses API pemuatan spreadsheet:

from aspose.cells_foss import Workbook

Langkah 3: Mengunggah Buku Kerja dari File

Berikan string jalur file ke Workbook() untuk memuat spreadsheet yang ada. Konstruktor menerima opsional password argument untuk file yang dilindungi:

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


---

### Langkah 4: Akses Lembar Kerja

Penggunaan `get_worksheet()` dengan indeks integer (berbasis 0) atau string nama lembaran. Gunakan `worksheets` properti untuk melihat berapa banyak lembar buku kerja yang berisi:

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=“Copy code”

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

Langkah 5: Baca Nilai Sel

Akses sel melalui Worksheet.cells properti. penggunaan Cells.cell(row, col) ke mengambil sebuah Cell dengan koordinat baris dan kolom berbasis nol. Baca data dengan Pengumuman Cell.value properti. penggunaan Cell.is_empty() untuk melewati sel-sel kosong dengan aman:

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


---

### Langkah 6: Iterasi Semua Baris

Penggunaan `Cells.iter_rows()` untuk berjalan melalui semua baris tanpa mengetahui dimensi. Pass `values_only=True` untuk menerima nilai Python biasa bukan `Cell` objek:

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>

Masalah dan Fixes Umum

FileNotFoundError saat pengisian Periksa bahwa jalurnya benar dan file tersebut ada. Gunakan pathlib.Path untuk portabel jalur: Workbook(str(Path("data") / "report.xlsx")).

Cell.value pengembalian None Sel kosong atau tidak dapat diakses. Cell.is_empty() untuk memeriksa sebelum membaca value.Koordinat di luar kisaran tidak menimbulkan kesalahan mereka mengembalikan sel kosong.

File yang dilindungi kata sandi menimbulkan kesalahan Pasang password sebagai argumen kedua: Workbook("protected.xlsx", "secret").

Hanya lembar pertama yang dimuat saat membaca CSV File CSV berisi satu lembar. Gunakan Workbook.load_csv(file_path) pada yang ada Workbook contoh jika Anda perlu mengimpor data CSV ke posisi sheet tertentu daripada membaca melalui Workbook() Konstruksi langsung.

Nama lembar tidak ditemukan dengan get_worksheet(name) Nama lembar sensitif huruf besar. cetak ws.name untuk setiap indeks di wb.worksheets ke konfirmasi nama tepat sebelum menelepon get_worksheet("Name").

Pertanyaan yang sering ditanya

Apakah ini bekerja pada Linux dan macOS?

Ya, aku tahu. aspose-cells-foss adalah Python murni dan berjalan di Windows, macOS, Linux, dan Docker kontainer tanpa ekstensi asli atau ketergantungan sistem.

Format file apa yang bisa saya muat?

Pengelolaan Workbook() Konstruktor mendukung file XLSX. File CSV dapat dimuat dengan melewati sebuah .csv jalur atau dengan menelepon Workbook.load_csv(file_path) pada a Workbook contoh.

Bagaimana saya menemukan baris terakhir dengan data?

Iterasi dengan Cells.iter_rows() dan berhenti ketika semua nilai dalam baris adalah None, atau penggunaan Cell.is_empty() pada sel batas untuk mendeteksi di mana data berakhir.

Bisakah saya membuka buku kerja tanpa mengetahui formatnya sebelumnya?

Berikan jalur file ke … Workbook(file_path). Perpustakaan menyimpulkan format dari ekstensi file dan header. Jika eksensi hilang atau ambigu, gunakan opsi format save/load yang jelas.

Bagaimana aku membaca sel dengan alamat suratnya seperti “B3”?

Gunakan baris dan kolom berbasiskan nol: B3 adalah baris 2, kolom 1. Konversi alamat surat dengan: ord(col_letter) - ord("A") untuk kolom berhuruf tunggal. Misalnya, B adalah: ord("B") - ord("A") == 1, jadi cells.cell(2, 1) Peta ke B3.