كيفية البدء مع Aspose.Cells FOSS لـ Python

aspose-cells-foss لـ Python هو مكتبة مجانية مرخصة من MIT للإنشاء والقراءة والوصول إلى تحويل ملفات الورق المقطع - لا Microsoft Office مطلوب، لا التمديدات الأصلية، النقي Python من PYPI.

خطوة بخطوة دليل

pip install aspose-cells-foss>=26.3.1

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

from aspose.cells_foss import Workbook, SaveFormat

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook()
ws = wb.add_worksheet("Sales")

cells = ws.cells
cells.cell(1, 1).put_value("Product")
cells.cell(1, 2).put_value("Revenue")
cells.cell(2, 1).put_value("Widget A")
cells.cell(2, 2).put_value(12500)
cells.cell(3, 1).put_value("Widget B")
cells.cell(3, 2).put_value(8750)

wb.save("sales.xlsx", SaveFormat.XLSX)
print("sales.xlsx written.")

from aspose.cells_foss import Workbook

wb = Workbook("sales.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells

print(f"A1: {cells.cell(1, 1).value}")
print(f"B2: {cells.cell(2, 2).value}")

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook("sales.xlsx")
wb.save("sales.csv", SaveFormat.CSV)
wb.save("sales.md", SaveFormat.MARKDOWN)
print("CSV and Markdown exports written.")

مشكلات و تصحيحات مشتركة

ModuleNotFoundError: No module named 'aspose' تثبيت الحزمة في البيئة الافتراضية النشطة: pip install aspose-cells-foss. تأكيد مع pip show aspose-cells-foss.

FileNotFoundError عند تحميل كتاب العمل استخدام pathlib.Path بناء مسارات محمولة: Workbook(str(Path("data") / "file.xlsx")).

قيمة الخلية تعود None بعد القراءة الخلية فارغة أو خارج نطاق.استخدام Cell.is_empty() التحقق قبل القراءة value.

إخراج CSV يحتوي فقط على ورقة الأولى save() مع SaveFormat.CSV يخرج ورقة العمل النشطة فقط.استخدام set_active_worksheet() اختيار الورق الذي تريد تصديره قبل توفير.

لا يتم فتح ملف XLSX بواسطة Excel. تأكد من أنك تمر SaveFormat.XLSX وبدونها، فإن النموذج يخرج من الملف التمديد؛ إذا لم يكن هناك مسار .xlsx قد لا يكون التمديد المنتج صالحًا.

الأسئلة المتكررة

هل تتطلب الخلايا المضغوطة Microsoft Office؟?

لا. تقرأ المكتبة وتكتب ملفات الورق المقوى بشكل أصلي في Python النقي دون أي إدمان على Microsoft Office أو COM الأتمتة أو Windows APIs.

ما هي الإصدارات التي تدعمها Python؟?

Python 3.7 أو أحدث.الخزانة تعمل على حاويات Windows و macOS و Linux و Docker.

هل المكتبة مجانية للاستخدام التجاري؟?

نعم يتم إصدارها بموجب ترخيص MIT. يمكنك استخدامها وتعديلها وإعادة توزيعها لأي غرض، بما في ذلك التطبيقات التجارية.

كيف يمكنني إيتير على جميع الخلايا في ورقة واحدة؟?

استخدام Cells.iter_rows() إتقان صفوف حسب الصف:

from aspose.cells_foss import Workbook

wb = Workbook("data.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

ما هي النماذج التي يمكنني حفظها؟?

SaveFormat دعم XLSX, CSV, TSV, MARKDOWN,و ، و JSON.استخدام SaveFormat.from_extension(file_path) لتحديد تنسيق تلقائيًا من مسار الملف.

انظر أيضا

• FAQ — Aspose.Cells FOSS لـ Python
• كيفية تحميل اللوحات في Python
• كيفية حفظ اللوحات في Python
• بدء الدوكتاتوريات
• إشارة API