Aspose.Cells FOSS
Python
Hướng Dẫn Nhà Phát Triển
Features

Xuất Định dạng Bảng tính cho Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() lệnh gọi xử lý toàn bộ quy trình xuất — XLSX, CSV, TSV, Markdown hoặc JSON — bảo toàn giá trị ô và công thức mà không cần Microsoft Office.

Cài đặt và Thiết lập 

pip install aspose-cells-foss

Nhập các lớp cốt lõi:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

Các Định dạng Đầu ra Được Hỗ trợ

Định dạngHằng SaveFormatGhi chú
XLSXSaveFormat.XLSXĐịnh dạng mặc định; bảo toàn kiểu dáng, công thức, biểu đồ
CSVSaveFormat.CSVPhân tách bằng dấu phẩy; mặc định chỉ trang tính đầu tiên
TSVSaveFormat.TSVGiá trị phân tách bằng tab
MarkdownSaveFormat.MARKDOWNTạo bảng Markdown tiêu chuẩn
JSONSaveFormat.JSONBiểu diễn JSON có cấu trúc của dữ liệu trang tính

Quan trọng: Aspose.Cells FOSS làm không hỗ trợ xuất sang PDF, HTML, PNG, TIFF, DOCX hoặc PPTX. Những định dạng này chỉ có trong phiên bản thương mại aspose-cells-python của gói phần mềm.

Ví dụ sử dụng

Lưu dưới dạng XLSX

Định dạng mặc định khi lưu với một .xlsx phần mở rộng:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

Lưu dưới dạng CSV 

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Lưu dưới dạng Markdown

Xuất dữ liệu dạng bảng dưới dạng bảng Markdown — hữu ích cho tài liệu và việc tạo README:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

Kết quả là một bảng Markdown tiêu chuẩn:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown với Các Tùy chọn

Sử dụng MarkdownSaveOptions để kiểm soát chi tiết:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown sang String (trong bộ nhớ)

Tạo một chuỗi Markdown mà không ghi ra đĩa:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

Lưu dưới dạng JSON

Xuất dữ liệu workbook dưới dạng JSON có cấu trúc cho các pipeline API:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

Tải CSV và Lưu dưới dạng XLSX 

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

Mẹo và Thực hành Tốt nhất

Xuất Markdown

  • Sử dụng MarkdownHandler.save_markdown_to_string(wb) cho các trường hợp sử dụng trong bộ nhớ như phản hồi API.

Xuất CSV

  • Xuất CSV ghi worksheet đầu tiên theo mặc định.
  • Các ký tự đặc biệt (dấu phẩy, xuống dòng) trong giá trị ô sẽ được tự động đặt trong dấu ngoặc kép.

Xuất JSON

  • Xuất JSON sử dụng địa chỉ ô làm khóa. Thích hợp cho việc trao đổi dữ liệu; các công thức phức tạp được lưu dưới dạng chuỗi biểu thức.

Các vấn đề thường gặp và giải pháp

Vấn đềGiải pháp
ModuleNotFoundError: No module named 'aspose.cells_foss'Chạy pip install aspose-cells-foss và xác nhận môi trường ảo đang hoạt động
AttributeError trên SaveFormat.PDFXuất PDF không có trong thư viện FOSS; sử dụng SaveFormat.MARKDOWN hoặc SaveFormat.XLSX thay thế
Kết quả Markdown trốngĐảm bảo ít nhất một ô trong bảng có giá trị trước khi lưu
Vấn đề mã hoá trong MarkdownSử dụng MarkdownHandler.save_markdown_to_string() để xuất chuỗi trong bộ nhớ với kiểm soát mã hoá đầy đủ

Câu hỏi thường gặp

Các định dạng xuất nào mà Aspose.Cells FOSS hỗ trợ? XLSX, CSV, TSV, Markdown và JSON.

Tôi có thể chuyển đổi sang PDF không? Không. Xuất PDF yêu cầu phiên bản thương mại aspose-cells-python gói. Aspose.Cells FOSS chỉ xuất sang XLSX, CSV, TSV, Markdown và JSON.

Tôi có thể tải một tệp XLSX hiện có và lưu lại dưới dạng Markdown không? Có. Workbook("existing.xlsx") tải tệp, và workbook.save_as_markdown("output.md") xuất nó.

Có hỗ trợ đầu ra Markdown dựa trên luồng không? Có. Sử dụng MarkdownHandler.save_markdown_to_string(workbook) để lấy Markdown dưới dạng chuỗi Python mà không có bất kỳ I/O tệp nào.

Phiên bản Python nào được hỗ trợ? Python 3.7 và các phiên bản sau.

Xem thêm

 Tiếng Việt