چگونه در پایتون فایل ها را مدیریت کنیم؟
فرض کنید برنامهای نوشتهاید که ساعتها داده جمعآوری میکند، اما با اولین ریاستارت سرور همهچیز از بین میرود. دلیلش این امر آن است که متغیرها فقط در حافظه (RAM) زنده میمانند و برای ماندگار کردن گزارشها باید آنها را در فایل ذخیره کنید. لاگها، فایلهای پیکربندی، خروجیهای CSV و گزارشهای تحلیل داده، همگی به فایل نیاز دارند. مدیریت فایل در پایتون یادگرفتنی و ساده است. اما اگر اصول آن را رعایت نکنید، با فایلهای خراب، دادههای ازدسترفته یا خطاهای گیجکننده روبهرو میشوید. در این مقاله از بخش آموزش پایتون وبلاگ پارسپک، قدمبهقدم با باز کردن، خواندن، نوشتن، تغییر نام و حذف فایلها، کار با پوشهها و دادههای باینری و مدیریت خطاها آشنا میشوید تا بتوانید با اطمینان در پروژههای خود با فایل کار کنید.
مدیریت فایل مجموعه عملیاتی است که برای ایجاد، باز کردن، خواندن، نوشتن، تغییر نام، جابهجایی و حذف فایلها انجام میدهید. هسته این کار تابع داخلی ()open است و ماژولهای os ،shutil و pathlib هم برای کار با پوشهها و مسیرها در کنار آن قرار میگیرند. هر فایل با یک مسیر (Path) مشخص میشود. مسیر فایل در پایتون دو شکل دارد:
اگر برنامهتان را روی سرور اجرا میکنید، دسترسیهای فایل (Permission) و مسیر درست اهمیت بیشتری پیدا میکنند.
برای آشنایی با پایتون مقاله زیر را مطالعه کنید.
پایتون چیست؟
پایتون فایلها را در دو دسته کلی تقسیم میکند. این تفاوت مستقیماً روی حالت باز کردن فایل و روش خواندن آن اثر میگذارد:
هر فرمت رایج، ابزار مخصوص خودش را دارد، برای مثال:
مثال زیر خواندن و نوشتن یک فایل CSV را حاکی از آن است. پارامتر newline=”” از ایجاد خطهای خالی اضافه در ویندوز جلوگیری میکند:
import csv
with open("data.csv", "r", newline="", encoding="utf-8") as file:
for row in csv.reader(file):
print(row)
with open("output.csv", "w", newline="", encoding="utf-8") as file:
writer = csv.writer(file)
writer.writerow(["Name", "Age", "City"])
writer.writerow(["Ali", 30, "Tehran"])
برای JSON هم کافی است داده را با ()json.dump بنویسید. اگر دادهها فارسی هستند، ensure_ascii=False را فراموش نکنید تا متن بهصورت کدهای یونیکد ذخیره نشود:
import json
data = {"name": "علی", "city": "تهران"}
with open("data.json", "w", encoding="utf-8") as file:
json.dump(data, file, ensure_ascii=False, indent=2)
with open("data.json", "r", encoding="utf-8") as file:
print(json.load(file))
برای آشنایی با هاست پایتون مقاله زیر را بخوانید.
هاست پایتون چیست؟
آموزش کار با فایلها در پایتون همیشه از تابع ()open شروع کار میشود. این تابع مسیر فایل، حالت باز کردن و در صورت نیاز نوع رمزگذاری (Encoding) را میگیرد و یک شیء فایل (File Object) برمیگرداند. سه مرحله ثابت دارید: باز کردن فایل، انجام عملیات و بستن فایل:
file = open("example.txt", "r", encoding="utf-8")
content = file.read()
file.close()
همیشه پارامتر encoding=”utf-8″ را مشخص کنید.
اگر آن را ننویسید، پایتون از رمزگذاری پیشفرض سیستمعامل استفاده میکند و ممکن است متن فارسی روی یک سیستم درست و روی سیستم دیگر خراب شود.
برای آشنایی با نحوه نوشتن Doctest در پایتون مقاله زیر را بخوانید.
آموزش نوشتن Doctest در پایتون
حالت (Mode) مشخص میکند که فایل برای چه کاری باز شود. انتخاب اشتباه آن رایجترین دلیل از بین رفتن ناخواسته دادههاست، پس این فهرست را خوب بشناسید:
هر فایل بازشده منابع سیستم را اشغال میکند و دادههای نوشتهشده ابتدا در بافر (Buffer) میمانند و با بستن فایل روی دیسک ذخیره میشوند. اگر فایل را نبندید، ممکن است بخشی از دادهها ذخیره نشود یا فایل در ویندوز قفل بماند. برای بستن فایل از متد close() استفاده کنید و برای اطمینان از وضعیت آن، خصوصیت closed را تحلیل کنید:
file = open("example.txt", "r", encoding="utf-8")
file.close()
print(file.closed) # True
دریافت فایلهای کنونی در پایتون
برای کار با فایلهای موجود، اول باید بدانید برنامه در کدام پوشه اجرا میشود، چون مسیرهای نسبی نسبت به همین پوشه حساب میشوند. تابع ()os.getcwd مسیر پوشه کاری فعلی (Current Working Directory) را بهصورت رشته برمیگرداند. برای اینکه مطمئن شوید فایل یا پوشهای در این مسیر هست، از ()os.path.exists و ()os.path.isfile استفاده کنید:
import os
print(os.getcwd())
print(os.path.exists("example.txt"))
print(os.path.isfile("example.txt"))
خواندن فایل در پایتون
پایتون چند روش برای خواندن دارد و انتخاب درست بین آنها به اندازه فایل بستگی دارد:
with open("example.txt", "r", encoding="utf-8") as file:
print(file.read(10)) # first 10 characters
print(file.readline()) # next line
print(file.readlines()) # remaining lines as a list
- خواندن فایلهای بزرگ: ()read و ()readlines کل فایل را وارد حافظه میکنند و برای فایل چند گیگابایتی مناسب نیستند. راه درست، پیمایش مستقیم شیء فایل در حلقه است که هر بار فقط یک خط را در حافظه نگه میدارد:
with open("large.log", "r", encoding="utf-8") as file:
for line in file:
print(line.strip())
نحوه تغییر پوشه در پایتون
برای جابهجا شدن بین پوشهها از ()os.chdir استفاده میشود. بعد از اجرای آن، همه مسیرهای نسبی نسبت به پوشه نوین حساب میشوند، پس در برنامههای بزرگ بهتر است با احتیاط از آن استفاده کنید:
import os
os.chdir("/home/user/projects")
print(os.getcwd())
در ویندوز مسیرها را با اسلش معمولی بنویسید یا قبل از رشته r بگذارید، مانند: r”C:UsersAli”. تا بکاسلشها بهعنوان کاراکتر خاص تفسیر نشوند.
برای آشنایی با کاربردها، مزیتها و راهنمای مفصل نصب و راهاندازی پایتون برای مبتدیان مقاله زیر را بخوانید.
آموزش پایتون برای مبتدیان
تابع ()os.listdir نام همه فایلها و پوشههای یک مسیر را برمیگرداند. اگر مسیری ندهید، پوشه فعلی را ارزیابی میکند. ترتیب برآیند تضمینشده نیست، پس برای مرتبسازی از ()sorted کمک بگیرید. برای فیلتر کردن مطابق پسوند فایل پایتون میتوانید از متد endswith() یا ماژول glob استفاده کنید:
import os, glob
print(sorted(os.listdir(".")))
txt_files = [f for f in os.listdir(".") if f.endswith(".txt")]
print(txt_files)
print(glob.glob("*.csv"))
نحوه تغییر نام فایل در پایتون
تابع ()os.rename نام قدیمی را در آرگومان اول و نام نوین را در آرگومان دوم میگیرد. اگر فایل مبدأ وجود نداشته باشد، FileNotFoundError رخ میدهد. نکته مهم این است که اگر فایلی با نام مقصد وجود داشته باشد، ویندوز خطا میدهد، اما لینوکس بیصدا آن را جایگزین میکند. برای رفتار یکسان در هر دو سیستم از ()os.replace استفاده کنید:
import os
os.rename("old_name.txt", "new_name.txt")
os.replace("new_name.txt", "backup.txt")
نحوه حذف فایل در پایتون

حذف فایل در پایتون با تابع ()os.remove انجام میشود. فایل حذفشده به سطل بازیافت نمیرود و بهسادگی قابل بازگشت نیست، بنابراین بهتر است قبل از حذف، وجود آن را تحلیل کنید. برای حذف پوشه خالی از ()os.rmdir و برای پوشهای که محتوا دارد از ()shutil.rmtree استفاده کنید:
import os, shutil
if os.path.exists("temp.txt"):
os.remove("temp.txt")
os.rmdir("empty_folder")
shutil.rmtree("folder_with_files")
نوشتن در فایل در پایتون
برای نوشتن، فایل را با حالت w باز کنید و از متد ()write استفاده کنید. این متد هیچ خط بهروزی خودکار اضافه نمیکند و باید n را خودتان بنویسید. اگر میخواهید چند خط را یکجا بنویسید، ()writelines یک لیست از رشتهها را میگیرد، اما آن هم انتهای خطها را اضافه نمیکند. به یاد داشته باشید که حالت w محتوای قبلی فایل را جامعاً پاک میکند:
with open("notes.txt", "w", encoding="utf-8") as file:
file.write("Hello, world!n")
file.writelines(["Line 2n", "Line 3n"])
نحوه خواندن و نوشتن دادههای باینری
برای فایلهایی مانند تصویر، صدا یا فایل فشرده، حالتهای rb و wb را به کار ببرید. در این حالتها پایتون با شیء bytes کار میکند، نه رشته، و هیچ تبدیل رمزگذاری انجام نمیدهد. مثال زیر یک فایل باینری مینویسد و سپس آن را میخواند:
with open("example.bin", "wb") as file:
file.write(bytes([0, 1, 2, 3, 4, 5, 6, 7]))
with open("example.bin", "rb") as file:
data = file.read()
print(data)
برای کپی کردن فایلهای حجیم مانند تصویر یا ویدیو، آن را تکهتکه بخوانید تا حافظه پر نشود:
with open("photo.jpg", "rb") as src, open("copy.jpg", "wb") as dst:
while chunk := src.read(1024 * 1024):
dst.write(chunk)
کار با دایرکتوریها در پایتون
ماژول os برای ایجاد و مدیریت دایرکتوری (Directory) یا همان پوشه، ابزارهای لازم را دارد. ()os.mkdir یک پوشه میسازد و اگر از قبل وجود داشته باشد خطا میدهد. ()os.makedirs مسیرهای تودرتو را یکجا میسازد و با exist_ok=True در صورت وجود پوشه خطا نمیدهد. برای پیمایش مفصل یک پوشه و همه زیرپوشههای آن هم ()os.walk را داریم:
import os
os.mkdir("example")
os.makedirs("reports/2026/october", exist_ok=True)
for folder, subfolders, files in os.walk("reports"):
print(folder, files)
ماژول pathlib هم روش شیءگرا و خواناتری برای کار با مسیرها ارائه میدهد. برای نمونه: Path(“reports”) / “data.txt” مسیر را بدون نگرانی از تفاوت اسلش در سیستمعاملها میسازد.
اگر میخواهید بدون پاک شدن محتوای قبلی، متن تازهی به انتهای فایل اضافه کنید، حالت a را انتخاب کنید. کد اضافه کردن به فایل txt در پایتون همینقدر ساده است و برای نوشتن لاگ یا ثبت رویدادها بسیار کاربرد دارد. هر بار اجرای این کد، یک خط تازه به انتهای فایل اضافه میشود و اگر فایل وجود نداشته باشد، ساخته میشود:
with open("log.txt", "a", encoding="utf-8") as file:
file.write("New log entryn")
پس اگر هدف شما اضافه کردن متن به فایل متنی است، همیشه از a استفاده کنید، نه w. در حالت a شیء فایل همیشه از انتهای فایل مینویسد، حتی اگر قبل از نوشتن، مکاننما را جابهجا کرده باشید.
تا اینجا بیشتر مثالها با دستور with نوشته شدند و دلیلش این است که with یک Context Manager است و فایل را بعد از پایان کار بلوک، حتی اگر وسط کار خطا رخ دهد، خودکار میبندد. دیگر لازم نیست ()close را به خاطر بسپارید. این روش استاندارد کار با فایل در پایتون است و میتوانید چند فایل را هم در یک دستور باز کنید:
with open("source.txt", "r", encoding="utf-8") as src, open("target.txt", "w", encoding="utf-8") as dst:
dst.write(src.read())
مدیریت خطاها هنگام کار با فایل در پایتون
هنگام کار با فایل باید انتظار خطا داشته باشید. به طور مثال ممکن است که فایل وجود نداشته باشد، دسترسی کافی نداشته باشید یا مسیر بهجای فایل به یک پوشه اشاره کند. برای جلوگیری از توقف ناگهانی برنامه، کدی را که ممکن است خطا بدهد داخل بلوک try میگذاریم و با except خطا را مدیریت میکنیم. مثال زیر باز کردن فایلی است که وجود ندارد:
try:
file = open("example.txt", "r")
content = file.read()
file.close()
except FileNotFoundError:
print("The file does not exist.")
در عمل خطاهای دیگری هم پیش میآید و بهتر است هر کدام را جداگانه مدیریت کنید. خطاهای رایج عبارتاند از:
در ادامه یک مثال برای درک بهتر آورده شده است که میتوانید آن را تحلیل کنید:
try:
with open("example.txt", "r", encoding="utf-8") as file:
content = file.read()
except FileNotFoundError:
print("The file does not exist.")
except PermissionError:
print("You do not have permission to open this file.")
except IsADirectoryError:
print("The path points to a directory, not a file.")
except UnicodeDecodeError:
print("The file encoding is not UTF-8.")
جمعبندی
مدیریت فایلها در پایتون صرفا یک کار عمومی مثل جابهجایی دادهها در موبایل یا ویندوز نیست. بلکه مهارت کنترل و ذخیرهسازی پایدار دادهها در سطح اسکریپتنویسی است. با تسلط بر توابعی مثل ()open و دستور with، میتوانید خروجی برنامههای خود را از RAM خارج کرده و بهطور ایمن در قالب لاگ، دیتابیس یا گزارش ذخیره کنید. این اصول برای توسعه سیستمهای پردازش کلانداده و بکاپگیری مفصلا ضروری هستند. برای اجرای بدون وقفه و مدیریت حرفهای برنامههای پایتونی خود، میتوانید از سرویس قدرتمند PaaS پایتون پارسپک استفاده کنید.
حالت w فایل را برای نوشتن باز میکند و محتوای قبلی آن را پاک میکند، اما حالت a محتوای قبلی را نگه میدارد و متن بهروز را به انتهای فایل اضافه میکند. اگر فایل وجود نداشته باشد، هر دو حالت آن را میسازند.
دستور with فایل را بعد از اتمام بلوک، حتی در صورت بروز خطا، بهطور خودکار میبندد. این کار از نشت منابع و از دست رفتن دادههای موجود در بافر جلوگیری میکند و کد را کوتاهتر و خواناتر میکند.
بهجای ()read و ()readlines که کل فایل را وارد حافظه میکنند، فایل را مستقیم در یک حلقه for پیمایش کنید. در این روش هر بار فقط یک خط در حافظه نگه داشته میشود. برای فایلهای باینری هم میتوانید ()read را با اندازه مشخص و در یک حلقه استفاده کنید.
علت معمولاً ناسازگاری رمزگذاری است. اگر هنگام باز کردن فایل encoding را مشخص نکنید، پایتون از رمزگذاری پیشفرض سیستم استفاده میکند. برای جلوگیری از این مشکل، همیشه encoding=”utf-8″ را در ()open بنویسید.
سوالات متداول
چگونه در پایتون فایلها را مدیریت کنیم؟ چیست؟
در این مطلب اطلاعات، جزئیات و نکات مرتبط با چگونه در پایتون فایلها را مدیریت کنیم؟ بررسی شده است.
چرا چگونه در پایتون فایلها را مدیریت کنیم؟ اهمیت دارد؟
این موضوع به دلیل اطلاعات و کاربردهای مرتبط، مورد توجه کاربران قرار گرفته است.
آخرین اطلاعات درباره فایل چیست؟
جدیدترین اطلاعات و تغییرات مربوط به فایل در این گزارش ارائه شده است.
