آموزش کار با Excel در پایتون با openpyxl

رفیق برنامه‌نویس، اگه تا حالا با فایل‌های اکسل توی پایتون کلانجار رفتی و دنبال یه راه حل ساده و قدرتمند بودی، درست اومدی! OpenPyXL رفیق شفیقته برای مدیریت این فایل‌ها. تو این راهنمای جامع، قدم به قدم یادت میدیم چطور با این کتابخونه جادویی، هر کاری از خوندن داده‌ها گرفته تا ساختن گزارش‌های خفن رو انجام بدی. آماده‌ای که با فایل‌های Excel خداحافظی کنی و همه کارها رو با کد خودت مدیریت کنی؟ پس بزن بریم!
همین الان برای تجهیز ابزار برنامه‌نویسیتون، یه سر به فروشگاه ابزارهای برنامه‌نویسی ما بزنید و دنیایی از امکانات رو کشف کنید!
برای مشاوره و پشتیبانی تلفنی می‌تونید با شماره 09202232789 تماس بگیرید.

نقشه راه تسلط بر OpenPyXL 🚀

pip install openpyxl

import openpyxl

from openpyxl import load_workbook

# باز کردن یک فایل اکسل موجود
workbook = load_workbook('example.xlsx')
print("فایل اکسل با موفقیت باز شد!")
    

# انتخاب شیت فعال
sheet = workbook.active
print(f"شیت فعال: {sheet.title}")

# انتخاب شیت با نام مشخص
# اگر شیتی با این نام وجود نداشته باشد، خطا می‌دهد
sheet_by_name = workbook['Sheet1']
print(f"شیت 'Sheet1': {sheet_by_name.title}")
    

# دسترسی به سلول A1
cell_a1 = sheet['A1']
print(f"مقدار سلول A1: {cell_a1.value}")

# دسترسی به سلول با استفاده از ردیف و ستون
cell_b2 = sheet.cell(row=2, column=2)
print(f"مقدار سلول B2: {cell_b2.value}")
    

# خواندن یک ردیف کامل (از ردیف اول)
for cell in sheet[1]:
    print(cell.value, end=" | ")
print("n")

# خواندن یک ستون کامل (از ستون اول)
for cell in sheet['A']:
    print(cell.value)
    

print("خواندن همه ردیف‌ها:")
for row in sheet.iter_rows():
    for cell in row:
        print(cell.value, end="t")
    print()

print("nخواندن ردیف‌ها با محدودیت (مثلا از ردیف 2 تا 5، ستون A تا C):")
for row in sheet.iter_rows(min_row=2, max_row=5, min_col=1, max_col=3):
    for cell in row:
        print(cell.value, end="t")
    print()
    

from openpyxl import Workbook

# ساخت یک ورک‌بوک جدید
new_workbook = Workbook()
new_sheet = new_workbook.active
new_sheet.title = "داده‌های جدید"
print(f"ورک‌بوک جدید با شیت '{new_sheet.title}' ساخته شد.")
    

new_sheet['A1'] = "نام"
new_sheet['B1'] = "سن"
new_sheet.cell(row=2, column=1, value="علی")
new_sheet.cell(row=2, column=2, value=30)
new_sheet['A3'] = "سارا"
new_sheet['B3'] = 25
print("داده‌ها به شیت اضافه شدند.")
    

data = [
    ["محصول", "قیمت", "تعداد"],
    ["لپ تاپ", 1500, 5],
    ["موس", 25, 20],
    ["کیبورد", 75, 10]
]

for row_data in data:
    new_sheet.append(row_data)
print("ردیف‌های جدید به شیت اضافه شدند.")
    

new_workbook.save("my_new_file.xlsx")
print("فایل 'my_new_file.xlsx' با موفقیت ذخیره شد.")
    

new_sheet2 = new_workbook.create_sheet("گزارش ماهانه")
print(f"شیت '{new_sheet2.title}' ایجاد شد.")
    

new_sheet.title = "لیست کالاها"
print(f"نام شیت به '{new_sheet.title}' تغییر یافت.")
    

# workbook.remove(new_sheet2)
# print(f"شیت '{new_sheet2.title}' حذف شد.")
# (فعلا این خط رو کامنت می‌کنیم تا فایل رو خراب نکنیم!)
    

from openpyxl.styles import Font, PatternFill

# اعمال فونت و رنگ
header_cell = new_sheet['A1']
header_cell.font = Font(name='B Titr', size=14, bold=True, color="FF0000") # رنگ قرمز
header_cell.fill = PatternFill(start_color="FFFF00", end_color="FFFF00", fill_type="solid") # پس زمینه زرد
print("فرمت‌دهی سلول A1 انجام شد.")
    

from openpyxl.styles import Alignment

new_sheet['B1'].alignment = Alignment(horizontal="center", vertical="center")
print("تراز بندی سلول B1 انجام شد.")
    

new_sheet.merge_cells('A5:C5')
new_sheet['A5'] = "گزارش فروش سه ماهه"
new_sheet['A5'].alignment = Alignment(horizontal="center", vertical="center")
new_sheet['A5'].font = Font(size=16, bold=True)
print("سلول‌های A5:C5 ادغام شدند.")
    

new_sheet.column_dimensions['A'].width = 20
new_sheet.row_dimensions[1].height = 30
print("عرض ستون A و ارتفاع ردیف 1 تنظیم شد.")
    

جدول آموزشی: روش‌های اصلی فرمت‌دهی در OpenPyXL

# فرض کنید در سلول B6 و B7 اعدادی داریم که میخواهیم جمع کنیم
new_sheet['B6'] = 100
new_sheet['B7'] = 200
new_sheet['B8'] = "=SUM(B6:B7)" # اضافه کردن فرمول جمع
print("فرمول جمع در سلول B8 اضافه شد.")

# برای دیدن نتیجه فرمول باید فایل رو باز کنی
# اگر بخواهی نتیجه فرمول رو با پایتون بخونی، باید workbook رو در حالت data_only=True لود کنی
# یا بعد از ذخیره، با اکسل باز و ذخیره کنی.
    

import datetime
from openpyxl.styles import numbers

new_sheet['C1'] = datetime.date(2023, 10, 26)
new_sheet['C1'].number_format = numbers.FORMAT_DATE_YYYYMMDD2
print("تاریخ به سلول C1 اضافه و فرمت شد.")
    

💡 نکته مهم برای نمودارها و اینفوگرافیک‌ها

برای اینفگرافیک‌های پیچیده یا نمودارهای تعاملی، استفاده از ابزارهای تخصصی‌تر یا کتابخانه‌هایی مثل Matplotlib و Plotly در پایتون توصیه میشه. بعد از تولید اینفوگرافیک با این ابزارها، می‌تونی اونها رو به عنوان عکس به فایل اکسل اضافه کنی. OpenPyXL بیشتر برای مدیریت داده‌ها و ساختار Excel عالیه تا طراحی گرافیکی پیچیده.

به جای تمرکز بر ایجاد مستقیم نمودار با OpenPyXL، بهتره داده‌ها رو آماده کنی و سپس از پایتون برای تولید فایل‌های تصویری (PNG, JPG) نمودار استفاده کنی و اونا رو به اکسل اضافه کنی.

from openpyxl import load_workbook
from openpyxl.styles import Font

try:
    workbook = load_workbook('students.xlsx')
    sheet = workbook.active

    # اضافه کردن سربرگ "معدل" در ستون بعدی
    sheet.cell(row=1, column=sheet.max_column + 1, value="معدل").font = Font(bold=True)

    # پیمایش روی ردیف‌ها از ردیف دوم (بعد از سربرگ)
    for row_index in range(2, sheet.max_row + 1):
        # خواندن نمرات
        grade1 = sheet.cell(row=row_index, column=2).value
        grade2 = sheet.cell(row=row_index, column=3).value
        grade3 = sheet.cell(row=row_index, column=4).value

        # محاسبه معدل
        if all(isinstance(g, (int, float)) for g in [grade1, grade2, grade3]):
            average = (grade1 + grade2 + grade3) / 3
            # نوشتن معدل در ستون جدید
            sheet.cell(row=row_index, column=sheet.max_column, value=round(average, 2))
        else:
            sheet.cell(row=row_index, column=sheet.max_column, value="خطا در نمرات")

    # ذخیره فایل جدید
    workbook.save('students_with_average.xlsx')
    print("فایل 'students_with_average.xlsx' با موفقیت ایجاد شد و معدل‌ها محاسبه گردید.")

except FileNotFoundError:
    print("خطا: فایل 'students.xlsx' یافت نشد. لطفا مطمئن شوید فایل در مسیر صحیح قرار دارد.")
except Exception as e:
    print(f"خطایی رخ داد: {e}")
    

from openpyxl import load_workbook, Workbook

# برای خواندن فایل‌های بزرگ
read_only_wb = load_workbook('large_file.xlsx', read_only=True)
for row in read_only_wb.active.iter_rows():
    # پردازش ردیف‌ها بدون لود کردن کل فایل در حافظه
    pass

# برای نوشتن فایل‌های بزرگ
write_only_wb = Workbook(write_only=True)
ws = write_only_wb.create_sheet()
for row_data in some_large_dataset:
    ws.append(row_data)
write_only_wb.save('new_large_file.xlsx')
    

⛔️ مشکل ۱: FileNotFoundError

راه حل: مطمئن شو که فایل اکسل در مسیر درستی قرار داره. اگه فایل کنار اسکریپت پایتونته، فقط اسمش کافیه. وگرنه باید مسیر کاملش رو بدی (مثلاً 'C:/Users/User/Desktop/my_file.xlsx'). همچنین، اگه فایل رو باز گذاشتی، ببندش.

⛔️ مشکل ۲: PermissionError: [Errno 13] Permission denied

راه حل: این خطا معمولاً وقتی رخ میده که فایل اکسل مورد نظر توسط برنامه دیگه‌ای (مثل خود Excel) بازه. قبل از اجرای اسکریپت پایتون، مطمئن شو که فایل مورد نظر بسته‌ است. همچنین، بررسی کن که اسکریپتت دسترسی لازم برای نوشتن/خواندن در اون مسیر رو داره یا نه. (برای سیستم‌عامل‌های ویندوز، گاهی نیاز به اجرای ترمینال به صورت Administrator داری.)

⛔️ مشکل ۳: Data type issues (مثلاً خواندن عدد به جای تاریخ)

راه حل: OpenPyXL سعی می‌کنه نوع داده‌ها رو درست تشخیص بده، اما گاهی اوقات نیاز به تبدیل دستی داری. برای تاریخ، می‌تونی از ماژول datetime پایتون استفاده کنی. برای اعداد، مطمئن شو که مقادیر قبل از عملیات ریاضی به int یا float تبدیل شدن.

⛔️ مشکل ۴: سلول‌ها هنگام خواندن خالی هستند (cell.value is None)

راه حل: مطمئن شو که به شیت و سلول درستی دسترسی داری. گاهی اوقات فرمول‌ها در اکسل هنوز محاسبه نشده‌اند. برای خواندن نتیجه فرمول‌ها، باید فایل را با load_workbook('file.xlsx', data_only=True) باز کنی. این کار فقط مقادیر (نتیجه فرمول‌ها) را می‌خواند، نه خود فرمول‌ها را.

⛔️ مشکل ۵: استایل‌ها اعمال نمی‌شوند یا درست نمایش داده نمی‌شوند

راه حل: مطمئن شو که کلاس‌های استایل (مثل Font، PatternFill) را از openpyxl.styles import کرده‌ای. همچنین، برخی استایل‌های پیچیده ممکن است فقط در نسخه‌های جدیدتر Excel به درستی رندر شوند. همیشه بعد از اعمال استایل، فایل را ذخیره کن و با یک برنامه Excel باز کن تا نتیجه را ببینی.

آیا OpenPyXL فقط برای فایل‌های .xlsx است؟

بله، OpenPyXL فقط برای فرمت .xlsx (Office Open XML) طراحی شده است. برای کار با فرمت‌های قدیمی‌تر مثل .xls باید از کتابخانه‌های دیگری مانند xlrd و xlwt استفاده کنید.

آیا می‌توانم ماکروها (Macros) را با OpenPyXL مدیریت کنم؟

OpenPyXL برای مدیریت ماکروها (VBA) طراحی نشده و نمی‌تواند کدهای ماکرو را ایجاد یا ویرایش کند. تمرکز آن بر روی داده‌ها و ساختار فایل .xlsx است. اگر نیاز به کار با ماکروها دارید، باید از روش‌های دیگری مانند استفاده از pywin32 در ویندوز استفاده کنید که امکان تعامل مستقیم با برنامه Excel را فراهم می‌کند.

تفاوت OpenPyXL با pandas چیست؟

pandas یک کتابخانه قدرتمند برای تحلیل و دستکاری داده‌ها است که قابلیت خواندن و نوشتن فایل‌های اکسل را نیز دارد، اما با رویکرد DataFrame. OpenPyXL بیشتر برای مدیریت مستقیم ساختار و ظاهر فایل‌های اکسل (شیت‌ها، سلول‌ها، فرمت‌دهی، فرمول‌ها) طراحی شده است، بدون اینکه لایه پیچیده‌ای از تحلیل داده را اضافه کند. معمولاً در پروژه‌های بزرگتر، از pandas برای پردازش داده‌ها و سپس از OpenPyXL (یا موتور اکسل داخلی pandas) برای خروجی نهایی به اکسل استفاده می‌شود.