כיצד להתחיל עם Aspose.Cells FOSS עבור Python

aspose-cells-foss עבור Python היא ספרייה חינם, מורשה על ידי MIT ליצירת, קריאה ו הפוך קבצי לוח זרם – אין דרישה של Microsoft Office, אין הרחבות מקומיות, טהור Python מתוך PyPI.

מדריך שלב‑אחר‑שלב

שלב 1: התקנת החבילה

הפעלת פיפ עם PIP:

pip install aspose-cells-foss>=26.3.1

בדוק את ההתקנה:

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

שלב 2: ייבוא שיעורים נדרשים

from aspose.cells_foss import Workbook, SaveFormat

שלב 3: יצירת ספר עבודה וכתוב נתונים

שימוש Workbook() כדי ליצור ספר עבודה חדש.הוספת לוח עבודה עם add_worksheet(),ואז גישה לרשת האיברים שלה דרך cells רכוש ושימוש Cells.cell(row, col) כדי לקבל A Cell.ערכים עם Cell.put_value():

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

שלב 4: קרא את ספר העבודה בחזרה

להעלות קובץ קיימים על ידי העברת מסלול הקובצית ל Workbook(file_path).שימוש get_worksheet() על ידי אינדיקטור או שם, ולאחר מכן לקרוא ערכים תאים דרך value רכוש :

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

שלב 3: שמור לפורמט היעד

Workbook.save() תמיכה בפורמטים מרובים באמצעות SaveFormat.שימוש SaveFormat.CSV עבור ייצור נפרד ו SaveFormat.MARKDOWN עבור לוח Markdown:

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 ייתכן שההרחבה של היצוא אינה בתוקף.

שאלות נפוצות

האם תאי aspose-foss דורשים Microsoft Office?

הספרייה קוראת ומכתבת קבצי שורת הפריטים באופן מקורי ב-Python טהור ללא כל תלות על Microsoft Office, אוטומציה COM, ו/או API Windows.

אילו גרסאות של 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) כדי לזהות את הפורמט באופן אוטומטי מתוך מסלול קובץ.