Set `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` property เพื่อดูว่าหนังสือทํางานมีใบกี่แผ่น:

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>

ขั้นตอนที่ 5: อ่านค่าเซลล์

เซลล์ทางเข้าผ่าน Worksheet.cells ทรัพย์สิน การใช้งาน Cells.cell(row, col) ไปยัง ค้นหา a 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").

คําถามที่พบบ่อย

มันทํางานกับลินคัสและแม็คโอเอสไหม?

ใช่แล้ว. aspose-cells-foss เป็น Python สด และทํางานบน Windows, macOS, Linux, Docker คอนเทนเนอร์ที่ไม่มีขยายพื้นฐานหรือความพึ่งพาของระบบ.

รูปร่างบางประเภท (Connectors, PictureFrames, GroupShapes) ไม่มี text frame ควรตรวจสอบด้วย `shape.has_text_frame()` ก่อนเข้าถึงข้อความ?

การ Workbook() constructor รองรับไฟล์ XLSX. CSV ไฟล์สามารถถูกอัตราการโดยผ่าน a .csv ทาง หรือโทรหา Workbook.load_csv(file_path) ใน a Workbook อย่างเช่น.

ผมหาแถวสุดท้ายที่มีข้อมูลได้อย่างไร?

อีเทอเรตกับ Cells.iter_rows() และหยุดเมื่อค่าทั้งหมดในแถวถูก None,หรือ การใช้งาน Cell.is_empty() ในเซลล์ขอบเขต เพื่อตรวจสอบที่ข้อมูลจบลง.

ผมสามารถเปิดหนังสือทํางานได้หรือไม่ ถ้าผมไม่รู้รูปแบบก่อน?

ส่งทางไฟล์ไปยัง … Workbook(file_path). ห้องสมุดสรุปรูปแบบจาก การขยายไฟล์และหัวหน้าไฟฟ้า หากการขยับฟิล์หายไปหรือไม่ชัดเจน ใช้ตัวเลขที่กําหนดไว้ในลักษณะของเอกสาร ตัวเลือกรูปแบบ Save/Load อย่างชัดเจน.

ฉันจะอ่านเซลล์ได้อย่างไร โดยที่อยู่ของจดหมาย เช่น “B3”?

ใช้จํานวนเต็มแถวและคอลัมน์ที่ใช้ศูนย์: B3 เป็นแถลง 2 คอล์ม 1 แปลงอ้างอิงจดหมาย มี ord(col_letter) - ord("A") สําหรับคอลัมน์ที่มีตัวอักษรเดียว เช่น, B คือ ord("B") - ord("A") == 1,ดังนั้น cells.cell(2, 1) แผนที่ B3.