Làm thế nào để tải một bảng điều khiển trong Python

Hướng dẫn này cho thấy cách tải các tệp bảng điều khiển XLSX và CSV trong Python bằng cách sử dụng Workbook,- Truy cập vào các trang web với get_worksheet(), và đọc các giá trị tế bào thông qua Worksheet.cells Thư viện chạy trong Python sạch mà không có Microsoft Office hoặc phần mở rộng bản địa.

Hướng dẫn từng bước

Bước 1: Cài Đặt Gói

Cài đặt gói FOSS từ PyPI bằng cách sử dụng lệnh pip dưới đây:

pip install aspose-cells-foss>=26.3.1

Kiểm tra cài đặt bằng cách nhập khẩu Workbook Và in một thông điệp xác nhận:

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

Bước 2: Nhập các lớp học cần thiết

nhập khẩu của Workbook lớp từ aspose.cells_foss để truy cập vào bảng tải API:

from aspose.cells_foss import Workbook

Bước 3: Tải sổ làm việc từ một tệp

Chuyển file path string đến Workbook() tải một bảng điều khiển hiện có. Nhà sản xuất chấp nhận một tùy chọn password Các tài liệu bảo vệ:

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


---

### Bước 4: Truy cập một bảng điều khiển

Sử dụng `get_worksheet()` với một chỉ số toàn diện (0 dựa trên) hoặc dòng tên lá. Sử dụng The `worksheets` tài sản để xem bao nhiêu lá trong sổ làm việc chứa:

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>

Bước 5: Đọc giá trị tế bào

Access Cell thông qua Worksheet.cells Tài sản - Sử dụng Cells.cell(row, col) để Nhận A Cell bằng các chuỗi dựa trên zero và tọa độ cột. đọc dữ liệu với Các Cell.value Tài sản - Sử dụng Cell.is_empty() Để thoát khỏi các tế bào trắng an toàn:

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


---

### Bước 6: Tải tất cả các rễ

Sử dụng `Cells.iter_rows()` đi qua tất cả các hàng mà không biết chiều. Pass `values_only=True` để nhận được các giá trị Python rõ ràng thay vì `Cell` Các đối tượng:

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>

Các vấn đề chung và Fixes

FileNotFoundError Khi tải Kiểm tra rằng con đường là đúng và tệp tồn tại. sử dụng pathlib.Path Đối với Portable Đường : Workbook(str(Path("data") / "report.xlsx")).

Cell.value trở lại None Ống là trống hay không có phạm vi. sử dụng Cell.is_empty() Kiểm tra trước khi đọc value.Các tọa độ ngoài phạm vi không gây ra lỗi - chúng trả về các tế bào trống.

File Password Protected gây ra lỗi Hãy nhập mật khẩu như là câu trả lời thứ hai: Workbook("protected.xlsx", "secret").

Chỉ có tấm đầu tiên được tải lên khi đọc CSV CSV file chứa một bảng. sử dụng Workbook.load_csv(file_path) Trong một hiện có Workbook Ví dụ nếu bạn cần nhập dữ liệu CSV vào vị trí bảng cụ thể Thay vì đọc qua Workbook() Nhà sản xuất trực tiếp.

Tên trang không được tìm thấy với get_worksheet(name) Tên của trang là trường hợp nhạy cảm. in ws.name Đối với mỗi chỉ số trong wb.worksheets để xác nhận tên chính xác trước khi gọi điện thoại get_worksheet("Name").

Thường xuyên hỏi câu hỏi

Điều này có hoạt động trên Linux và macOS không?

Có . aspose-cells-foss Python và chạy trên Windows, macOS, Linux và Docker. container mà không có bất kỳ mở rộng hoặc phụ thuộc hệ thống bản địa nào.

Tôi có thể tải các định dạng tệp nào?

Các Workbook() nhà xây dựng hỗ trợ tệp XLSX. CSV có thể được tải bằng cách chuyển qua một .csv đường hay bằng cách gọi Workbook.load_csv(file_path) trên a Workbook trường hợp .

Làm thế nào để tìm ra hàng cuối cùng với dữ liệu?

Iterate với Cells.iter_rows() và dừng khi tất cả các giá trị trong một hàng là None,hoặc Sử dụng Cell.is_empty() trên các tế bào biên giới để phát hiện nơi dữ liệu kết thúc.

Tôi có thể mở một cuốn sách làm việc mà không biết định dạng trước?

Đi qua đường file đến Workbook(file_path).Thư viện cung cấp các định dạng từ file extension và file headers. nếu phần mở rộng thiếu hoặc không rõ ràng, sử dụng một Chọn tùy chọn Save/Lad Format.

Làm thế nào để tôi đọc một ô bằng địa chỉ chữ của nó như “B3”?

Sử dụng dòng dựa trên không và các cột toàn bộ: B3 là hàng 2, col 1. chuyển đổi địa chỉ chữ cái Với ord(col_letter) - ord("A") trong các văn bản đơn; ví dụ:, B là ord("B") - ord("A") == 1, như vậy cells.cell(2, 1) Bản đồ B3.