KAHIBARO Bookshelves
Discord Login Register

10.4. مسیر فایل‌ها

آشنایی با مسیر فایل‌ها در پایتون

در این بخش روی «مسیر فایل‌ها» (File Paths) تمرکز می‌کنیم؛ یعنی این‌که پایتون چطور می‌فهمد کدام فایل را باز کند و آن فایل کجای سیستم قرار دارد.

مسیر مطلق و مسیر نسبی

هر فایل در سیستم‌عامل، یک «آدرس» دارد که به آن مسیر (path) می‌گوییم.

مسیر مطلق (Absolute Path)

مسیر مطلق، آدرسی است که از ریشهٔ سیستم‌عامل شروع می‌شود و بدون وابستگی به محل فعلی شما، همان فایل را نشان می‌دهد.

  • در ویندوز شبیه این است:

C:\Users\Ali\Documents\data.txt

  • در macOS / لینوکس شبیه این است:

/home/ali/documents/data.txt
یا
/Users/ali/Documents/data.txt

در پایتون می‌توانید مستقیم از مسیر مطلق استفاده کنید:

file = open("C:/Users/Ali/Documents/data.txt", "r", encoding="utf-8")
text = file.read()
file.close()

یا در لینوکس / macOS:

file = open("/home/ali/documents/data.txt", "r", encoding="utf-8")

مسیر نسبی (Relative Path)

مسیر نسبی نسبت به «پوشهٔ کاری فعلی» (current working directory) تفسیر می‌شود؛ یعنی نسبت به جایی که پایتون الان در آن قرار دارد.

فرض کنید پوشهٔ کاری فعلی شما این باشد:

C:/Users/Ali/Projects/my_app

و در داخل آن پوشه، فایلی به نام notes.txt باشد. آن‌وقت کافی‌ست بنویسید:

file = open("notes.txt", "r", encoding="utf-8")

اگر فایلی در زیرپوشه باشد:

ساختار:

  • my_app/
    • data/
      • numbers.txt

مسیر نسبی:

file = open("data/numbers.txt", "r", encoding="utf-8")

اگر باید به پوشهٔ بالاتر بروید، از .. استفاده می‌شود:

  • . یعنی پوشهٔ فعلی
  • .. یعنی پوشهٔ والد (بالایی)

مثال: فرض کنید اسکریپت شما در:

C:/Users/Ali/Projects/my_app/scripts/app.py

و فایل داده در:

C:/Users/Ali/Projects/my_app/data/info.txt

در این‌صورت، از دید فایل app.py، برای رسیدن به info.txt:

file = open("../data/info.txt", "r", encoding="utf-8")

مشکل اسلش‌ها: ویندوز در برابر لینوکس / macOS

در ویندوز معمولاً مسیرها با \ (backslash) نوشته می‌شوند:

C:\Users\Ali\Documents\data.txt

ولی در پایتون، \ داخل رشته‌ها برای «کاراکترهای ویژه» هم استفاده می‌شود (مثل \n برای خط جدید). اگر مستقیم این‌طور بنویسید:

path = "C:\Users\Ali\Documents\data.txt"

ممکن است پایتون بعضی تکه‌ها را اشتباه تفسیر کند (مثلاً \U شروع یک کد یونیکد است).

راه‌حل‌ها:

۱. استفاده از `/` به‌جای `\`

پایتون روی ویندوز هم / را به‌خوبی می‌فهمد:

path = "C:/Users/Ali/Documents/data.txt"
file = open(path, "r", encoding="utf-8")

۲. استفاده از رشتهٔ خام (raw string)

رشتهٔ خام با r شروع می‌شود و در آن \ تفسیر خاصی نمی‌شود:

path = r"C:\Users\Ali\Documents\data.txt"
file = open(path, "r", encoding="utf-8")

۳. دو بار نوشتن `\`

path = "C:\\Users\\Ali\\Documents\\data.txt"

اما در عمل، ساده‌ترین روش‌ها معمولاً استفاده از / یا r"..." هستند.

پوشهٔ کاری فعلی (Current Working Directory)

وقتی با مسیرهای نسبی کار می‌کنید، خیلی مهم است بدانید «پایتون الان در کدام پوشه است؟».

برای کار با مسیرها و پوشهٔ کاری، می‌توانید از ماژول os استفاده کنید.

دیدن پوشهٔ کاری فعلی

import os
current = os.getcwd()
print(current)

خروجی مثلاً می‌تواند چیزی مثل این باشد:

C:\Users\Ali\Projects\my_app

هر مسیری که نسبی بنویسید، نسبت به همین پوشه تفسیر می‌شود.

تغییر پوشهٔ کاری فعلی

می‌توانید با chdir پوشهٔ کاری را عوض کنید:

import os
os.chdir("C:/Users/Ali/Documents")
print(os.getcwd())  # حالا این پوشه، پوشهٔ کاری فعلی است

بعد از این کار، اگر بنویسید:

file = open("notes.txt", "r", encoding="utf-8")

پایتون دنبال notes.txt داخل پوشهٔ C:/Users/Ali/Documents می‌گردد.

ماژول `os.path` برای کار با مسیرها

ماژول os.path توابعی برای ساختن و دست‌کاری مسیرها ارائه می‌دهد. مزیتش این است که روی ویندوز، لینوکس و macOS، خودش فرمت مناسب مسیر را رعایت می‌کند.

ساختن مسیر با `join`

به‌جای این‌که خودتان / یا \ بگذارید، از os.path.join استفاده کنید:

import os
base = "C:/Users/Ali/Documents"
filename = "data.txt"
path = os.path.join(base, filename)
print(path)

روی ویندوز ممکن است چیزی مثل این چاپ شود:

C:\Users\Ali\Documents\data.txt

اگر زیرپوشه هم دارید:

path = os.path.join("data", "2024", "sales.csv")
print(path)  # مثلا: data/2024/sales.csv

گرفتن پوشهٔ یک مسیر (`dirname`) و نام فایل (`basename`)

اگر یک مسیر کامل دارید و می‌خواهید «فقط پوشه» یا «فقط نام فایل» را بگیرید:

import os
path = "C:/Users/Ali/Documents/data/sales.csv"
folder = os.path.dirname(path)
name = os.path.basename(path)
print("پوشه:", folder)   # C:/Users/Ali/Documents/data
print("نام فایل:", name) # sales.csv

مسیر کامل از روی مسیر نسبی (`abspath`)

اگر می‌خواهید ببینید یک مسیر نسبی، دقیقاً به چه مسیر مطلقی تبدیل می‌شود:

import os
relative = "data/sales.csv"
absolute = os.path.abspath(relative)
print("مسیر نسبی:", relative)
print("مسیر مطلق:", absolute)

چک کردن وجود مسیر (`exists`، `isfile`، `isdir`)

وقتی می‌خواهید با یک مسیر کار کنید، بد نیست اول بررسی کنید آیا وجود دارد یا نه:

import os
path = "data/sales.csv"
print(os.path.exists(path))  # آیا این مسیر وجود دارد؟
print(os.path.isfile(path))  # آیا این مسیر یک فایل است؟
print(os.path.isdir(path))   # آیا این مسیر یک پوشه است؟

این کار کمک می‌کند قبل از باز کردن فایل، از واقعی بودن مسیر مطمئن شوید و خطاهای غیرمنتظره کم‌تر شوند.

استفاده از `pathlib` (روش مدرن‌تر)

کتابخانهٔ pathlib یک روش شی‌ءگرا و خواناتر برای کار با مسیرها ارائه می‌کند. ایدهٔ اصلی این است که به‌جای رشته، یک «شیء مسیر» داشته باشید.

ساختن یک مسیر با `Path`

from pathlib import Path
# مسیر نسبی
p = Path("data") / "sales.csv"
print(p)  # data/sales.csv
# مسیر مطلق خانۀ کاربر
home = Path.home()
print(home)

در این‌جا از عملگر / برای چسباندن بخش‌های مسیر استفاده شده است که خواناتر از os.path.join است.

تبدیل به رشته

بعضی تابع‌ها (مثل open) با رشته کار می‌کنند، پس می‌توانید مسیر را به رشته تبدیل کنید:

from pathlib import Path
p = Path("data") / "sales.csv"
print(str(p))

اما open جدیدترها مستقیماً با Path هم کار می‌کند:

from pathlib import Path
p = Path("data") / "sales.csv"
with p.open("r", encoding="utf-8") as f:
    text = f.read()

چک کردن وجود مسیر در `pathlib`

مشابه os.path:

from pathlib import Path
p = Path("data") / "sales.csv"
print(p.exists())
print(p.is_file())
print(p.is_dir())

مسیر نسبی نسبت به محل فایل پایتون

گاهی می‌خواهید فایل‌های متنی را «نسبت به جایی که خود اسکریپت قرار دارد» آدرس‌دهی کنید، نه نسبت به پوشهٔ کاری فعلی (که ممکن است هنگام اجرای برنامه، فرق کند).

در بسیاری از موارد می‌توانید این الگو را استفاده کنید:

from pathlib import Path
# مسیر فایل فعلی (اسکریپت)
current_file = Path(__file__)
# پوشه‌ای که این فایل در آن است
base_dir = current_file.parent
# فایل data.txt که کنار همین فایل پایتون است
data_path = base_dir / "data.txt"
with data_path.open("r", encoding="utf-8") as f:
    text = f.read()

این روش کمک می‌کند برنامهٔ شما مستقل از این‌که از کدام پوشه اجرا می‌شود، بتواند فایل‌های همراه خودش را پیدا کند.

نکات عملی هنگام کار با مسیرها

  • اگر برنامه‌تان روی سیستم‌های مختلف (ویندوز، لینوکس، macOS) اجرا می‌شود، بهتر است از os.path یا pathlib استفاده کنید تا مشکل \ و / را نداشته باشید.
  • برای تمرین، ابتدا با مسیرهای نسبی ساده در همان پوشهٔ پروژه کار کنید: مثلاً data/input.txt.
  • وقتی خطای «No such file or directory» می‌گیرید، معمولاً یعنی:
    • پوشهٔ کاری فعلی چیز دیگری است، یا
    • مسیر را اشتباه نوشته‌اید (حروف کوچک/بزرگ، نام پوشه، پسوند فایل).
  • در ویندوز، برای جلوگیری از مشکل با \، از یکی از این سه روش استفاده کنید:
    • /
    • r"..."
    • یا pathlib / os.path.join

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

Where to Move

Move chapter:

  • ☰ 1. فصل ۱: برنامه‌نویسی چیست؟
    • ☰ 1.1. برنامهٔ کامپیوتری چیست؟
      • ☰ 1.2. پایتون چیست؟
        • ☰ 1.3. پایتون کجا استفاده می‌شود؟
          • ☰ 1.4. چگونه برنامه‌نویسی به حل مسائل کمک می‌کند
            • ☰ 1.5. اولین برنامهٔ پایتون شما
            • ☰ 2. فصل ۲: راه‌اندازی پایتون
              • ☰ 2.1. نصب پایتون (ویندوز / macOS / لینوکس)
                • ☰ 2.2. استفاده از پایتون در ترمینال
                  • ☰ 2.3. استفاده از یک IDE (IDLE / VS Code)
                    • ☰ 2.4. اجرای اسکریپت‌های پایتون
                      • ☰ 2.5. حالت تعاملی پایتون
                      • ☰ 3. فصل ۳: متغیرها و انواع داده
                        • ☰ 3.1. متغیر چیست؟
                          • ☰ 3.2. ایجاد متغیرها
                            • ☰ 3.3. اعداد (`int`، `float`)
                              • ☰ 3.4. متن (`str`)
                                • ☰ 3.5. مقادیر بولی (`True`، `False`)
                                  • ☰ 3.6. بررسی نوع داده با `type()`
                                  • ☰ 4. فصل ۴: عملیات پایه
                                    • ☰ 4.1. عملیات حسابی
                                      • ☰ 4.2. کار با اعداد
                                        • ☰ 4.3. عملیات روی رشته‌ها
                                          • ☰ 4.4. ترکیب متن و متغیرها
                                            • ☰ 4.5. کامنت‌ها در پایتون
                                            • ☰ 5. فصل ۵: ورودی و خروجی کاربر
                                              • ☰ 5.1. دریافت ورودی از کاربر
                                                • ☰ 5.2. تبدیل ورودی به عدد
                                                  • ☰ 5.3. قالب‌بندی خروجی
                                                    • ☰ 5.4. نوشتن برنامه‌های تعاملی
                                                    • ☰ 6. فصل ۶: شرط‌ها (if / else)
                                                      • ☰ 6.1. عملگرهای مقایسه‌ای
                                                        • ☰ 6.2. عملگرهای منطقی
                                                          • ☰ 6.3. if، elif، else
                                                            • ☰ 6.4. شرط‌های تو در تو
                                                              • ☰ 6.5. اشتباهات رایج مبتدیان
                                                              • ☰ 7. فصل ۷: حلقه‌ها
                                                                • ☰ 7.1. چرا حلقه‌ها مفید هستند؟
                                                                  • ☰ 7.2. حلقه‌های while
                                                                    • ☰ 7.3. حلقه‌های for
                                                                      • ☰ 7.4. شمارنده‌های حلقه
                                                                        • ☰ 7.5. break و continue
                                                                          • ☰ 7.6. تمرین‌های حلقه
                                                                          • ☰ 8. فصل ۸: مجموعه‌های داده
                                                                            • ☰ 8.1. لیست‌ها (Lists)
                                                                              • ☰ 8.2. تاپل‌ها (Tuples)
                                                                                • ☰ 8.3. دیکشنری‌ها (Dictionaries)
                                                                                  • ☰ 8.4. مجموعه‌ها (Sets – مقدماتی)
                                                                                    • ☰ 8.5. انتخاب ساختار دادهٔ مناسب
                                                                                    • ☰ 9. فصل ۹: توابع
                                                                                      • ☰ 9.1. چرا توابع مهم هستند؟
                                                                                        • ☰ 9.2. تعریف توابع
                                                                                          • ☰ 9.3. پارامترها و آرگومان‌ها
                                                                                            • ☰ 9.4. مقادیر بازگشتی
                                                                                              • ☰ 9.5. محدودهٔ متغیرها (محلی در برابر سراسری)
                                                                                                • ☰ 9.6. استفادهٔ مجدد از کد
                                                                                                • ☰ 10. فصل ۱۰: کار با فایل‌ها
                                                                                                  • ☰ 10.1. فایل چیست؟
                                                                                                    • ☰ 10.2. خواندن فایل‌های متنی
                                                                                                      • ☰ 10.3. نوشتن و افزودن به فایل‌ها
                                                                                                        • ☰ 10.4. مسیر فایل‌ها
                                                                                                          • ☰ 10.5. برنامه‌های ساده مبتنی بر فایل
                                                                                                          • ☰ 11. فصل ۱۱: خطاها و اشکال‌زدایی
                                                                                                            • ☰ 11.1. انواع خطاها
                                                                                                              • ☰ 11.2. خواندن پیام‌های خطا
                                                                                                                • ☰ 11.3. خطاهای رایج مبتدیان
                                                                                                                  • ☰ 11.4. try و except
                                                                                                                    • ☰ 11.5. راهبردهای اشکال‌زدایی
                                                                                                                    • ☰ 12. فصل ۱۲: استفاده از کتابخانه‌های پایتون
                                                                                                                      • ☰ 12.1. کتابخانه چیست؟
                                                                                                                        • ☰ 12.2. وارد کردن ماژول‌ها
                                                                                                                          • ☰ 12.3. کتابخانه‌های استاندارد
                                                                                                                            • ☰ 12.3.1. math
                                                                                                                              • ☰ 12.3.2. random
                                                                                                                                • ☰ 12.3.3. datetime
                                                                                                                                • ☰ 12.4. نصب کتابخانه‌های خارجی با pip
                                                                                                                                • ☰ 13. فصل ۱۳: برنامه‌نویسی شی‌گرا (OOP)
                                                                                                                                  • ☰ 13.1. برنامه‌نویسی شی‌گرا چیست؟
                                                                                                                                    • ☰ 13.2. کلاس‌ها و اشیاء
                                                                                                                                      • ☰ 13.3. ویژگی‌ها و متدها
                                                                                                                                        • ☰ 13.4. متد `__init__`
                                                                                                                                          • ☰ 13.5. کپسوله‌سازی
                                                                                                                                            • ☰ 13.6. وراثت (مقدماتی)
                                                                                                                                              • ☰ 13.7. مثال‌های سادهٔ شی‌گرا
                                                                                                                                              • ☰ 14. فصل ۱۴: خودکارسازی با پایتون
                                                                                                                                                • ☰ 14.1. خودکارسازی چیست؟
                                                                                                                                                  • ☰ 14.2. خودکار کردن وظایف ساده
                                                                                                                                                    • ☰ 14.3. کار با فایل‌ها و پوشه‌ها
                                                                                                                                                      • ☰ 14.4. خودکارسازی پردازش متن
                                                                                                                                                        • ☰ 14.5. زمان‌بندی اجرای اسکریپت‌ها
                                                                                                                                                          • ☰ 14.6. مثال‌های کاربردی خودکارسازی
                                                                                                                                                          • ☰ 15. فصل ۱۵: توسعهٔ وب با پایتون
                                                                                                                                                            • ☰ 15.1. وب چگونه کار می‌کند؟ (نمای کلی)
                                                                                                                                                              • ☰ 15.2. آشنایی با Flask
                                                                                                                                                                • ☰ 15.3. ساخت یک وب‌سرور ساده
                                                                                                                                                                  • ☰ 15.4. مسیرها و قالب‌ها (Templates)
                                                                                                                                                                    • ☰ 15.5. پردازش ورودی کاربر (فرم‌ها)
                                                                                                                                                                      • ☰ 15.6. API های بسیار ساده
                                                                                                                                                                      • ☰ 16. فصل ۱۶: علم داده با پایتون
                                                                                                                                                                        • ☰ 16.1. علم داده چیست؟
                                                                                                                                                                          • ☰ 16.2. کار با داده‌ها
                                                                                                                                                                            • ☰ 16.3. آشنایی با NumPy
                                                                                                                                                                              • ☰ 16.4. آشنایی با pandas
                                                                                                                                                                                • ☰ 16.5. مصورسازی داده با matplotlib
                                                                                                                                                                                  • ☰ 16.6. مثال‌های سادهٔ تحلیل داده
                                                                                                                                                                                  • ☰ 17. فصل ۱۷: پروژه‌های کوچک
                                                                                                                                                                                    • ☰ 17.1. بازی حدس عدد
                                                                                                                                                                                      • ☰ 17.2. ماشین‌حساب ساده
                                                                                                                                                                                        • ☰ 17.3. فهرست کارها (To-Do List)
                                                                                                                                                                                          • ☰ 17.4. تولیدکنندهٔ رمز عبور
                                                                                                                                                                                            • ☰ 17.5. برنامهٔ آزمون (Quiz)
                                                                                                                                                                                              • ☰ 17.6. پروژهٔ کوچک وب یا داده
                                                                                                                                                                                              • ☰ 18. فصل ۱۸: گام‌های بعدی
                                                                                                                                                                                                • ☰ 18.1. چگونه پایتون را تمرین کنیم
                                                                                                                                                                                                  • ☰ 18.2. نوشتن کد تمیز و خوانا
                                                                                                                                                                                                    • ☰ 18.3. انتخاب یک حوزهٔ تخصصی
                                                                                                                                                                                                      • ☰ 18.3.1. توسعهٔ وب
                                                                                                                                                                                                        • ☰ 18.3.2. علم داده
                                                                                                                                                                                                          • ☰ 18.3.3. خودکارسازی
                                                                                                                                                                                                            • ☰ 18.3.4. توسعهٔ نرم‌افزار
                                                                                                                                                                                                            • ☰ 18.4. منابع یادگیری و انجمن‌ها
                                                                                                                                                                                                            • ☰ 19. پیوست
                                                                                                                                                                                                              • ☰ 19.1. برگهٔ تقلب دستور زبان پایتون
                                                                                                                                                                                                                • ☰ 19.2. خطاهای رایج و راه‌حل‌ها
                                                                                                                                                                                                                  • ☰ 19.3. واژه‌نامهٔ اصطلاحات