وقتی میخوایم یه فایل پایتون بسازیم، مهمه که بدونیم فایل .py چیه. این فایل همون جاییه که کدهای پایتون رو داخلش میزاریم تا مفسر پایتون بتونه بخونه و اجراش کنه. توی ویندوز ساخت فایل py معمولا چند تا روش داره و هر روشی بسته به شرایط پروژه یا سطح آشنایی کاربر میتونه مناسب باشه. توی این قسمت از داکیومنت فارسی پایتون سعی میکنم مرحلهبهمرحله جلو بریم تا یاد بگیرین چگونه ساخت فایل پایتون انجام میشه.
اگه بخواین به سادهترین شکل ممکن فایل پایتون ایجاد کنین، توی ویندوز میتونین حتی با نوتپد این کار رو انجام بدین. مثلا فایل جدید رو باز میکنین، یه کد ساده مثل:
test.py
1
print("Hello Python")
داخلش کد رو مینویسین و بعد با نام test.py ذخیره میکنین. توی مرحله ذخیره فقط باید حواستون باشه که گزینه UTF-8 رو انتخاب کنین و پسوند فایل رو به صورت .py وارد کنین. این یعنی ساخت فایل py به سادهترین شکل ممکن انجام شده و فایل آماده اجرا هست.
اما معمولا کسی برای پروژه واقعی از نوتپد استفاده نمیکنه. بهترین و استانداردترین روش برای ساخت فایل پایتون استفاده از ادیتورهایی مثل Visual Studio Code هست. وقتی بخواین فایل .py در VS Code بسازین، همهچیز مرتبتر، قابلمدیریتتر و خیلی حرفهایتر پیش میره. توی VS Code فقط کافیه یه پوشه به عنوان پروژه انتخاب کنین، بعد از منوی File گزینه New File رو بزنین و فایل رو با یه نام درست ذخیره کنین. مثلا hello_world.py. انتخاب اسم درست خیلی مهمه، مثلا نباید از فاصله استفاده بشه، نباید با عدد شروع بشه و بهتره فقط از حروف کوچک، خط فاصله زیر (underscore) و اعداد استفاده کنین. این موضوع برای مدیریت فایلهای پایتون توی پروژه خیلی مهم میشه چون وقتی پروژه بزرگتر میشه، همین نظمِ اسمگذاری باعث میشه همهچیز قابلفهم و قابلدسترس بمونه.
ممکنه یه جاهایی بخواین از طریق ترمینال یا Command Line یه فایل .py بسازین، مخصوصاً وقتی دارین با محیطهای سادهتر یا پروژههای سبک کار میکنین. از طریق ترمینال ویندوز کافی هست توی مسیر پروژه این دستور رو بزنین:
Bash
1
type nul > script.py
و همین باعث میشه یه فایل خالی پایتون به اسم script.py ساخته بشه. بعدش میتونی با VS Code یا هر ادیتوری بازش کنی و کدت رو داخلش بنویسی. اگه قبلا فایل متنی داشتی و میخوای تبدیل به فایل .py بشه، فقط باید پسوندش رو عوض کنی، البته باید مطمئن باشی که محتوا واقعا کد پایتون هست، چون تغییر پسوند یه فایل متنی، اونو تبدیل به برنامه واقعی نمیکنه مگر اینکه کد داخلش درست نوشته شده باشه.
وقتی چند فایل .py میسازین، عملا دارین یه ساختار بهتر برای مدیریت پروژه ایجاد میکنین. مثلا اگه توی یه پروژه بخش ورودیها، بخش پردازش، و بخش خروجی جدا هستن، بهتره برای هر کدوم یه فایل پایتون جدا بسازین. این کار باعث میشه نهتنها مدیریت فایلهای پایتون راحتتر بشه، بلکه اجرای فایل py و اصلاح بخشهای مختلف هم سادهتر بشه.
در نهایت هر فایل .py که ساختین رو میتونین با دو روش اجرا کنین:
یا از طریق ترمینال داخل VS Code مثل:
Bash
1
python hello_world.py
یا از منوی Run توی خود VS Code که مخصوص اجرا کردن فایلهای پایتون هست. این اجرای فایل پایتون در VS Code مخصوصا برای مبتدیها راحتتره چون خروجی برنامه همونجا نمایش داده میشه و لازم نیست بین چند پنجره جابهجا بشن.
به طور خلاصه ساخت اسکریپت پایتون واقعا چیز پیچیدهای نیست، فقط کافیه بدونین فایل .py دقیقا چی هست و کجا باید ذخیره بشه. هرچی پروژه بزرگتر میشه، اهمیت محل ذخیره، اسمگذاری فایلها و مدیریت فایلهای پایتون بیشتر خودش رو نشون میده. این بخش از این داکیومنت فارسی پایتون کمک میکنه پایه ساخت فایل Python کامل جا بیفته تا توی ادامه مسیر برنامه نویسی پایتون و ساخت اسکریپتهای بزرگتر راحتتر و مرتبتر جلو برین.
وقتی صحبت از ساخت فایل پایتون یا همون ایجاد فایل Python در Visual Studio Code میشه، یعنی داریم وارد مرحلهای میشیم که قراره محیط کاری خودمون رو برای نوشتن برنامه آماده کنیم. VS Code یه ادیتور محبوب بین برنامهنویسهاست چون سبک، سریع و در عین حال خیلی قوی هست. پس اگه پایتون رو نصب کردین و قصد داری اولین اسکریپت پایتون رو بنویسین، وقتشه که یاد بگیرین چطور یه فایل .py توی VS Code بسازین.
اول از همه باید VS Code رو باز کنین. بعد بهتره یه پوشه به عنوان محل پروژه انتخاب کنین تا بتونین فایلهای .py رو به صورت منظم توی اون نگه دارین. از منوی File گزینهی Open Folder رو انتخاب کنین و مسیر پوشهای که میخواین پروژتون توش ذخیره بشه رو انتخاب کنین. این کار باعث میشه موقع مدیریت فایلهای پایتون، همهچیز مرتب باشه و بعداً وقتی چند فایل .py ساختین، راحتتر بتونین بینشون جابهجا بشین.
بعد از باز شدن پوشه، از منوی بالا گزینهی File → New File رو بزنین. توی پنجرهای که باز میشه میتونین اولین خطوط برنامتون رو بنویسین. مثلاً یه مثال ساده مثل:
hello_world.py
1
print("Hello World!")
الان وقت ذخیره فایل رسیده. با زدن Ctrl + S فایل رو ذخیره کنین و یه نام براش انتخاب کنین، مثلاً:
hello_world.py
اینجا چند تا نکتهی مهم وجود داره.
اول اینکه نامگذاری فایل پایتون توی VS Code باید با حروف کوچک و بدون فاصله باشه (البته بایدی در کار نیست ولی بهتره به این صورت باشه چون امکان داره در اینده وقتی پروژه بزرگتر شد به دلیل نامگذاری اشتباه به مشکل بخورین). اگه خواستین چند کلمه بنویسین، از “underscore” استفاده کنین. مثلاً:
my_first_program.py
برای مثال بالا نام گذاری زیر اشتباه هست:
my first program.py
دوم اینکه پسوند .py باید حتماً ته اسم فایل باشه چون پایتون از طریق همین پسوند تشخیص میده که فایل یه اسکریپت پایتونه. اگه پسوند اشتباه باشه، مثلاً .txt یا .py.txt ، موقع اجرای برنامه ارور میده یا اصلاً فایل رو به عنوان کد پایتون نمیشناسه.
وقتی فایل پایتون ساخته شد، VS Code خودش با تشخیص .py حالت سینتکس هایلایت مخصوص پایتون رو فعال میکنه، یعنی رنگ کلمهها مثل print و رشتههای "Hello Python" تغییر میکنن تا خوندن کد راحتتر باشه.
حالا که فایل ساخته شده، برای اجرای فایل py دو راه وجود داره.
یکی این که از پایین VS Code روی گزینهی Run Python File کلیک کنین، و دیگری اینکه از ترمینال داخلی خود VS Code استفاده کنین. ترمینال رو با کلیدهای Ctrl + ` باز کنین و بنویسین (به جای hello_world نام فایل خودتون رو باید بنویسین):
Bash
1
python hello_world.py
اگه پایتون درست نصب شده باشه و مسیرش به VS Code معرفی شده باشه، خروجی برنامه رو همون پایین میبینیم و خروجی چاپ میشه.
در این مرحله شما داریم اولین اسکریپت پایتون خودتون رو به شکل حرفهای مینویسین و اجرا میکنین، بدون اینکه نیاز باشه بین چند تا برنامه مختلف بپرین. VS Code کمک میکنه تا موقع نوشتن، خطاهای احتمالی رو هم با خط قرمز نشون بده؛ مثلاً اگه اسم تابع رو اشتباه بنویسین یا پرانتز رو فراموش کنین.
اگه بخواین فایلهاتون رو گسترش بدین، میتونین چند فایل .py توی همون پوشه بسازین تا پروژه ساختارمندتر بشه. مثلا یه فایل main.py برای اجرای برنامهی اصلی و یه فایل utils.py برای توابع کمکی. اینطوری مدیریت فایلهای پایتون سادهتر میشه و پروژه تمیزتر جلو میره.
به این ترتیب ایجاد فایل Python در Visual Studio Code نهتنها سادهست، بلکه بهتون کمک میکنه از همون اول استاندارد کار کنین. اجرای فایل py ، نامگذاری درست، انتخاب محل مناسب ذخیره فایلهای پایتون، و حتی اجرای دستور از طریق ترمینال، همه بخشی از فرآیند یادگیری برنامهنویسی حرفهای هستن. این بخش از داکیومنت فارسی پایتون قراره پایهی کار رو جوری محکم کنه که بعداً وقتی رفتین سراغ مباحث بزرگتر (مثل ساخت پروژههای چندفایلی یا کار با ماژولها)، بدون دردسر بتونین پیش برین.
اولین فایل .py نقش نقطه شروع برنامهنویسی پایتون رو داره و هدف از ساختش ایجاد یک فایل استاندارد برای اجرای کدهاست. فایل .py در اصل یک فایل متنی معمولی هست که کدهای پایتون داخلش قرار میگیره و مفسر پایتون اون رو اجرا میکنه. به همین دلیل ساخت فایل py مرحلهای مهم در شروع کار با پایتون محسوب میشه و پایهٔ تمام پروژههای بعدی رو تشکیل میده.
برای ساخت اولین اسکریپت پایتون، انتخاب محل ذخیره فایل پایتون اهمیت زیادی داره. معمولاً داخل یک پوشه مخصوص پروژه ذخیره میشه تا بعداً مدیریت فایلهای پایتون و گسترش ساختار پروژه راحتتر باشه. داخل همین پوشه فایل جدیدی با نام مناسب ایجاد میشه؛ مثلاً:
main.py
این نامگذاری کاملاً استاندارد محسوب میشه. فایلهای .py بهتره با حروف کوچک نوشته بشن، از فاصله استفاده نشه، و در صورت نیاز از underscore استفاده بشه. رعایت همین قواعد ساده در روش نام گذاری صحیح فایلهای .py باعث میشه کدهای پروژه در مراحل بزرگتر قابل فهم بمونن.
داخل این فایل میشه اولین خط برنامه رو نوشت. برای مثال:
main.py
1
print("Hello Python")
این یک برنامه کامل و قابل اجراست. پس از ذخیره فایل، اجرای فایل py از طریق ترمینال سیستم یا ترمینال VS Code انجام میشه. در ویندوز کافی هست دستور زیر اجرا بشه:
Bash
1
python main.py
این دستور میتونه برای سیستم های متفاوت فرق کنه و به شکل های زیر باشه:
Bash
1
py main.py
2
python3 main.py
اگه پایتون بهدرستی نصب شده باشه، خروجی نمایش داده میشه و این یعنی اولین اسکریپت پایتون با موفقیت اجرا شده.
در بعضی موارد کاربر قبلاً فایل متنی ایجاد کرده و قصد داره اون رو به فایل .py تبدیل کنه. این کار فقط با تغییر پسوند انجام میشه، اما محتوا باید واقعاً کد پایتون معتبر باشه. تغییر پسوند بهتنهایی فایل رو به برنامهی قابل اجرا تبدیل نمیکنه. این موضوع یکی از نکات مهم آموزش ساخت فایل .py در پایتون برای مبتدیهاست.
بعد از ساخت اولین فایل، امکان توسعه پروژه با ایجاد چند فایل .py در ادامه وجود داره. این کار معمولاً در پروژههای واقعی برای جداسازی بخشهای مختلف برنامه استفاده میشه و مدیریت فایلهای پایتون رو سادهتر میکنه. اما برای شروع کار، یک فایل اصلی کافی هست و مبنای یادگیری سینتکس و ساختار پایتون خواهد بود.
معمولاً این مرحله به عنوان نقطه اتصال بین «ساخت فایل پایتون» و «پایههای زبان پایتون» مطرح میشه، چون از این بخش به بعد تمام مثالها و کدها داخل همین فایلهای .py نوشته و اجرا میشن.
در مجموع، مراحل ایجاد فایل Python برای اجرای اولین برنامه شامل ساخت فایل .py ، نوشتن کد داخل اون، ذخیره فایل پایتون و اجرای فایل py هست. همین روند ساده بعدها اساس ساخت اسکریپتهای پیچیدهتر میشه و مسیر یادگیری رو کاملتر میکنه.
بخش نامگذاری فایلهای پایتون یکی از مهمترین مراحل بعد از ساخت فایل py محسوب میشه. هر فایل پایتون، چه در ویندوز و چه در Visual Studio Code، با پسوند .py شناخته میشه و مفسر پایتون از طریق همین پسوند فایل رو به عنوان یک اسکریپت قابل اجرا تشخیص میده. اما چیزی که اغلب نادیده گرفته میشه، نحوه نامگذاری این فایلهاست. نام درست باعث میشه اجرای فایل py بدون خطا انجام بشه و مدیریت فایلهای پایتون در پروژه خیلی راحتتر پیش بره.
اولین نکته در آموزش ساخت فایل .py ، استفاده از حروف کوچک (lowercase) هست. پایتون به خودش حساسیت کیس نداره، ولی سیستمعامل و ابزار توسعه مثل VS Code ممکنه در مسیر فایلها حساس باشن. مثلاً بهتره بنویسید data_processor.py به جای DataProcessor.py یا DATA_PROCESSOR.py تا هماهنگی بین نام فایل و ایمپورتها حفظ بشه.
در نامگذاری فایلهای .py نباید از فاصله (space) استفاده بشه، چون پایتون یا سیستم فایل ممکنه اون فاصله رو به شکل خاصی بخونه و در زمان import یا اجرای فایل py خطا بده. در عوض برای جداسازی کلمهها کاراکتر underscore (_) مناسبترین انتخابه. برای مثال:
نام درست: data_analysis_tools.py
نام نادرست: data analysis tools.py
قانون بعدی در نامگذاری فایلهای پایتون، شروع نام با حرف یا underscore هست. شروع نام فایل با عدد (0-9) میتونه موقع اجرای فایل پایتون یا import باعث خطا بشه، چون پایتون در ساختار نامگذاری ماژولها از قوانین مشابه نامگذاری متغیرها تبعیت میکنه. پس به جای 1st_script.py از _first_script.py یا first_script.py استفاده کنین.
برای ساخت فایل پایتون در ویندوز یا در Visual Studio Code، رعایت همین قواعد کوچک باعث میشه فایل py به درستی در پروژه شناخته بشه. اگر فایلت رو توی VS Code ذخیره کنین و نام فایل اشتباه باشه، ادیتور معمولاً با رنگ هشدار یا ارور در im dir="auto"port ها مشخص میکنه که مسیر یا نام فایل پایتون مشکل داره.
از کاراکترهای خاص مثل - ، @ ، ! ، یا # هیچوقت نباید استفاده بشه چون مفسر پایتون اونها رو در مسیر یا نام فایل مجاز نمیدونه. برای مثال:
درست: my_script.py
نادرست: my-script.py
در مدیریت فایلهای پایتون در پروژه، نظم و یکپارچگی نامها اهمیت زیادی داره. وقتی پروژه بزرگ میشه و چند فایل .py میسازین برای سازماندهی کدها، فایلها نباید نام مشابه یا مبهم داشته باشن. مثلاً در یک پروژه ممکنه فایلهای زیر وجود داشته باشن:
main.py
utilities.py
data_handler.py
visualization.py
ساخت چند فایل .py با این سبک نامگذاری، باعث میشه بخشهای مختلف برنامه واضح و قابل درک بشن و موقع اجرای فایل py یا im dir="auto"port هیچ تداخلی پیش نیاد.
گاهی کاربران فایل متنی معمولی دارن و میپرسن چگونه فایل متنی را به فایل .py تبدیل کنیم. کافی هست پسوند فایل رو به .py تغییر بدن، ولی باید مطمئن باشن که نام فایل از قوانین بالا پیروی میکنه، چون اگر در نام فایل از کاراکتر یا فاصله استفاده شده باشه، اجرای برنامه پایتون در ویندوز ممکنه با خطا متوقف بشه.
معمولاً این بخش به عنوان پیشنیاز مرحله ساخت و اجرای فایل .py در VS Code معرفی میشه، چون نام درست فایل پایتون یکی از فاکتورهایی هست که حتی روی نحوه اجرای فایل پایتون در ترمینال تأثیر میگذارد.
به عنوان نمونه، اگر فایلی با نام اشتباهی ایجاد شده باشه، مثلاً:
hello worl dir="auto"d.py
و در ترمینال نوشته بشه:
Bash
1
python hello world.py
سیستم این دستور رو به عنوان دو فایل جدا تفسیر میکنه و خطای can't open file 'he dir="auto"llo' برمیگردونه. ولی با نامگذاری صحیح:
Bash
1
py hello_world.py
برنامه بدون مشکل اجرا میشه.
در نهایت، نامگذاری صحیح فایلهای .py باید بخشی ثابت از عادت برنامهنویسی شما باشه. هم در ساخت فایل پایتون از طریق ترمینال ویندوز، هم در ایجاد فایل Python در Visual Studio Code یا هر ادیتور دیگه، رعایت این اصول باعث میشه ساخت اسکریپت پایتون دقیقتر انجام بشه و پروژه به شکل منظم رشد کنه. این دقت در نامها پایهٔ ساختار ماژولسازی و مدیریت فایلهای Python در پروژههای بزرگتر هست و در این داکیومنت فارسی پایتون دقیقاً برای همین هدف توضیح داده شده تا هر فایل از همون ابتدا استاندارد و قابلاعتماد ساخته بشه.
انتخاب محل ذخیره فایلهای پایتون، یکی از مهمترین بخشها در شروع ساخت فایل py و ایجاد فایل Python داخل یک پروژه هست. ساختار پوشهها روی نظم پروژه و مدیریت فایلهای پایتون تأثیر مستقیم داره، و اگه این بخش درست تنظیم نشه، حتی اجرای فایل py هم ممکنه با خطا روبهرو بشه.
محل ذخیره فایلهای .py بهتره یک پوشه مشخص برای پروژه باشه. این پوشه معمولاً شامل تمام اسکریپتها، فایلهای ورودی، تنظیمات و ماژولهایی میشه که در ادامه توسعه پروژه به کار میان. در ویندوز، کاربران معمولاً پوشهای مثل Desktop یا Documents انتخاب میکنن، اما بهترین کار ایجاد یک پوشه پروژه اختصاصی هست؛ مثلاً:
C:\Projects\python-intro\
در این مسیر میشه ایجاد فایل py رو راحت انجام داد و محیط پروژه همیشه واضح و قابل فهم میمونه. وقتی از Visual Studio Code استفاده میشه، بهتره همین پوشه رو Open Folder کنید و بعد شروع به ساخت فایل پایتون در VS Code کنید. این باعث میشه VS Code کل پروژه رو به عنوان یک workspace بشناسه و ویژگیهایی مثل اجرا، ترمینال داخلی و import بهتر کار کنن.
داخل این پوشه، اولین فایل .py ایجاد میشه. مثلاً:
main.py
ایجاد فایل Python در Visual Studio Code مرحله به مرحله دقیقاً از همین نقطه شروع میشه. با قرار گرفتن فایل در محل درست، اجرای فایل py در ترمینال چه در ویندوز چه در VS Code بدون دردسر انجام میشه.
انتخاب محل ذخیره فایلهای Python همچنین موقع ساخت چند فایل .py برای مدیریت و سازماندهی کدها اهمیت پیدا میکنه. وقتی پروژه بزرگتر میشه، فایلهایی مثل موارد زیر شکل میگیرن:
main.py
helpers.py
data_loader.py
اگه این فایلها در پوشههای مختلف و نامرتب قرار بگیرن، import کردن بین فایلها سخت میشه و حتی ممکنه پایتون خطایی مثل خطای ModuleNotFoundError بده. به همین دلیل در مراحل ایجاد فایل Python برای نوشتن کد، بهتره پروژه از ابتدا یک ساختار مشخص داشته باشه.
گاهی کاربر یک فایل متنی داره و میپرسه چگونه فایل متنی را به فایل .py تبدیل کنیم. این تبدیل فقط وقتی درست انجام میشه که فایل رو در همون پوشه پروژه ذخیره کنه، چون در غیر این صورت فایل در جایی قرار میگیره که هیچ ارتباطی با دیگر قسمتهای پروژه نداره و این باعث تداخل در import یا اجرای فایل py میشه.
در پروژههای پایتون، اهمیت محل ذخیره فایل پایتون حتی در مرحله نام گذاری فایل پایتون هم خودش رو نشون میده. وقتی فایلها در پوشه درستی قرار داشته باشن و نامشون استاندارد انتخاب شده باشه، تمام روند ساخت فایل پایتون، مدیریت فایلهای پایتون و اجرای فایل py به شکل طبیعی و بدون نیاز به تنظیمات اضافی پیش میره.
برای مثال، فرض کنیم فایل زیر در پوشه صحیح ذخیره شده:
script.py
و داخل فایل کدی شبیه زیر نوشته شده:
script.py
1
print("Project is ready")
در این حالت اجرای فایل در همان پوشه بهسادگی انجام میشه:
Bash
1
python script.py
اما اگر فایل در یک مسیر دیگر و خارج از پروژه قرار بگیره، اجرای فایل پایتون در ترمینال ویندوز نیازمند تغییر مسیر (cd) خواهد بود و در پروژههای چندفایلی این موضوع تبدیل به مزاحمت بزرگی میشه.
در نهایت انتخاب محل مناسب برای ذخیره فایلهای Python نهتنها بخشی از آموزش ساخت فایل .py در پایتون برای مبتدیهاست، بلکه پایهای برای تمام پروژههای آینده شماست. این مرحله باعث میشه ساخت فایل پایتون، ذخیره فایل پایتون و مدیریت فایلهای پایتون در ادامه مسیر بدون تداخل و با نظم دقیق انجام بشه.
خیلی از کاربران تصور میکنن فایل .py یک نوع فایل خاص و متفاوت از فایل متنی هست. اما در واقع اگر بخوایم دقیق نگاه کنیم، فایل .py چیزی جز یک فایل متنی ساده نیست که داخلش کد پایتون نوشته شده و با پسوند .py ذخیره شده. به همین دلیل در بسیاری از مواقع ممکنه یک فایل متنی معمولی داشته باشیم و بخوایم اون رو به یک اسکریپت قابل اجرای پایتون تبدیل کنیم.
وقتی این مفهوم درست درک بشه، مشخص میشه که تبدیل فایل متنی به فایل پایتون در اصل یعنی تغییر پسوند فایل و اطمینان از این که محتوای داخل اون کد معتبر پایتون هست.
فرض کنین یک فایل متنی ساده داریم که داخلش یک خط کد نوشته شده:
script.txt
1
print("Hello Python")
اگر این فایل با نام زیر ذخیره شده باشه:
script.txt
برای تبدیل به یک فایل پایتون کافی هست نام فایل رو تغییر بدیم و پسوند فایل رو از .txt به .py تبدیل کنیم:
script.py
بعد از این تغییر، فایل تبدیل به یک اسکریپت پایتون میشه و میشه اون رو با مفسر پایتون اجرا کرد. برای مثال در ترمینال ویندوز اجرای فایل py به شکل زیر انجام میشه:
Bash
1
python script.py
در اینجا پایتون محتوای فایل رو میخونه و اگر سینتکس کدها درست باشه، برنامه اجرا میشه.
نکته مهمی که برای ساخت فایل .py در پایتون باید بهش توجه کرد این هست که صرف تغییر پسوند فایل باعث نمیشه هر فایل متنی تبدیل به برنامه پایتون بشه. اگر داخل فایل متنی کد پایتون وجود نداشته باشه، حتی با پسوند .py هم اجرای فایل py نتیجهای نداره یا با خطای سینتکس روبهرو میشه. بنابراین هنگام تبدیل فایل متنی به فایل پایتون باید مطمئن باشین که محتوا واقعاً یک کد پایتون معتبر هست.
از طرف دیگه بهتره این فایل در همون محل مناسب ذخیره فایلهای Python در پروژه قرار بگیره. اگر فایل تبدیل شده در پوشه پروژه قرار داشته باشه، مدیریت فایلهای پایتون سادهتر میشه و در مراحل بعدی مثل نحوه ایجاد چند فایل .py برای مدیریت کدهای پایتون یا import کردن ماژولها مشکلی ایجاد نمیشه.
در محیطهای توسعه مثل Visual Studio Code هم همین منطق وجود داره. وقتی ساخت فایل پایتون در VS Code انجام میشه، در واقع یک فایل متنی ایجاد میشه که با پسوند .py ذخیره میشه. بنابراین ایجاد فایل Python در Visual Studio Code از نظر ساختار تفاوتی با تبدیل یک فایل متنی به فایل .py نداره؛ تنها تفاوت این هست که VS Code به طور خودکار سینتکس پایتون رو تشخیص میده و ابزارهای مناسب برنامهنویسی رو فعال میکنه.
در برخی مواقع هم ممکنه کاربر ابتدا یک فایل متنی در ویندوز بسازه و بعد تصمیم بگیره اون رو به یک اسکریپت پایتون تبدیل کنه. در این حالت کافیه هنگام ذخیره فایل پایتون، نام فایل رو با پسوند .py انتخاب کنه.
همچنین هنگام تغییر نام فایل باید به قواعد نام گذاری فایل پایتون هم توجه بشه. مثلاً بهتره از فاصله یا کاراکترهای خاص در نام فایل استفاده نشه. برای نمونه نامی مثل my_script.py انتخاب مناسبتری نسبت به my script.py هست، چون در زمان اجرای فایل py یا استفاده ازش توی پروژههای بزرگتر مشکل ایجاد نمیکنه.
در نهایت باید در نظر داشت که تبدیل فایل متنی به فایل .py در اصل یک تغییر ساده در ساختار فایل هست، اما درک درست این موضوع کمک میکنه مفهوم ساخت اسکریپت پایتون بهتر فهمیده بشه. وقتی بدونیم که هر برنامه پایتون در واقع یک فایل متنی با پسوند .py هست، فرآیندهایی مثل ساخت فایل py ، ذخیره فایل پایتون، اجرای فایل py و حتی مدیریت فایلهای پایتون در پروژه بسیار سادهتر و قابل درکتر میشن.
ساخت فایل py و ایجاد فایل Python همیشه محدود به محیطهای گرافیکی و ادیتوری مثل Visual Studio Code یا Notepad نیست. خیلی از برنامهنویسا، خصوصاً اونایی که با پروژههای بزرگتر سر و کار دارن، ترجیح میدن از ترمینال (Command Line) برای ساخت اسکریپت پایتون استفاده کنن. این روش، مخصوصاً زمانی که بخواین غیرتعامل با ماوس کار کنین یا موقع مدیریت فایلهای پایتون در پروژههای حرفهای اهمیت بیشتری پیدا میکنه.
در محیط ویندوز، با ابزارهایی مثل Command Prompt یا Windows Terminal، میتونیم بدون هیچ نرمافزار اضافی یک فایل .py بسازیم. کافیه با دستور زیر یک فایل خالی با پسوند .py توی پوشه فعلی ساخته بشه:
Bash
1
type nul > myscript.py
یا با استفاده از دستور echo، مستقیماً یک خط کد پایتون رو هم اضافه کنیم:
Bash
1
echo print("Hello from Python") > myscript.py
در سیستمعامل لینوکس یا مک هم میشه با دستور touch فایل رو بسازیم:
Bash
1
touch script.py
یا با echo همزمان یک کد ابتدایی بنویسیم:
Bash
1
echo 'print("Hello Python")' > script.py
بعد از این مرحله، وقتی فایل ساخته شد، میشه به راحتی با هر ویرایشگر متنی (nano، vim، یا حتی notepad در ویندوز) کدهای بیشتری بهش اضافه کرد:
Bash
1
notepad myscript.py
یا برای لینوکس:
Bash
1
nano script.py
یکی از مزیتهای این روش اینه که امکان مدیریت فایلهای پایتون توی پوشه پروژه راحتتره و مخصوصاً توی موقعیتهایی که باید چندین فایل .py برای مدیریت و سازماندهی کدهای پایتون بسازیم، سرعت کار بالا میره. اگه به نام گذاری فایل پایتون دقت کنین و از کاراکتر خاص یا فاصله اجتناب کنین (مثلاً my_util.py) بعداً هم واسه اجرای فایل py و هم import توی پروژه مشکلی نمیخورین.
ساخت فایل پایتون از طریق ترمینال هیچ فرقی با ایجاد فایل Python در VS Code از نظر خروجی نداره. فقط محیط و ابزار فرق میکنه، و خروجی همیشه یک فایل متنی با پسوند .py هست که پایتون اون رو به عنوان اسکریپت میشناسه. حتی میشه بعداً همین فایل رو توی VS Code باز کرد و مراحل ایجاد فایل Python برای نوشتن کد پایتون رو مثل محیط گرافیکی ادامه داد.
در نهایت، بعد از ساخت فایل .py از طریق Command Line، میتونیم خیلی راحت کدها رو اجرا کنیم:
Bash
1
python myscript.py
شکل ساخت فایل py به کمک ترمینال برای موقعیتهایی که با سرورهای ریموت، محیط مجازی یا پروژههای بزرگ کار میکنین، یکی از مهارتهای پایه و کاربردیه.
وقتی ساخت فایل py و ایجاد فایل Python انجام میشه، معمولاً اولین چیزی که کاربر نیاز داره اینه که بدونه فایلهای .py رو چطور باید داخل پوشه پروژه پایتون مدیریت کنه. این مرحله بعد از ساخت اولین فایل .py و قبل از گسترش پروژه با چند فایل مختلف اهمیت پیدا میکنه، چون ساختار درست پوشه پروژه باعث میشه اجرای فایل py بدون خطا انجام بشه و مسیرهای import هم همیشه واضح و قابل کنترل بمونن.
مدیریت فایلهای .py از همون جایی شروع میشه که یک پوشه مشخص برای پروژه ساختیم. وقتی محل مناسب ذخیره فایلهای Python در پروژه درست انتخاب بشه، بقیه مراحل مدیریت فایلها خیلی روان پیش میره. برای مثال یک ساختار ساده برای یک پروژه کوچک میتونه این شکلی باشه:
Location
1
C:.
2
└───project
3
├───main.py
4
├───utils.py
5
└───data_loader.py
در این ساختار، فایل main.py معمولاً نقطه شروع پروژه هست و بقیه فایلها نقش ماژولهایی رو دارن که codebase رو تمیزتر و قابل مدیریتتر میکنن. برای نمونه وقتی میخوایم از یک فایل به فایل دیگه کدی رو import کنیم، داشتن چنین ساختاری باعث میشه به راحتی بتونیم بنویسیم:
Bash
1
from utils import clean_data
اگه فایلها نام گذاری صحیح نداشته باشن یا نامگذاری فایل پایتون با استانداردهای رایج هماهنگ نباشه، حتی سادهترین import ممکنه خطا بده. برای همین بهتره هنگام ساخت اولین اسکریپت پایتون با فایل .py یا هنگام ایجاد فایل Python چه در ویندوز چه در Visual Studio Code، از نامهایی ساده و بدون فاصله استفاده کنیم.
وقتی ساخت فایل پایتون در VS Code انجام میشه، مدیریت فایلها بهخاطر بخش Explorer خیلی واضحتره. VS Code پوشه پروژه رو یک Workspace در نظر میگیره و این کمک میکنه هم ذخیره فایل پایتون، هم ساخت اسکریپت جدید، و هم اجرای فایل py همیشه از مسیر درست انجام بشه. اگه پروژه رو بدون باز کردن پوشه (Open Folder) شروع کنین، ممکنه هر فایل توی یه مسیر متفاوت ذخیره بشه و مدیریت فایلهای پایتون سخت بشه.
در ویندوز هم اگه از Command Line برای ساخت فایل پایتون استفاده کنین، مدیریت درست پوشه پروژه مهمه. مثلاً وقتی یک فایل جدید ایجاد میشه:
Bash
1
type nul > helper.py
اگه این فایل توی پوشه پروژه ایجاد نشه، بعداً موقع اجرای فایل py یا import کردنش مشکل بهوجود میاد.
گاهی هم بعد از تبدیل فایل متنی به فایل .py ، کاربر فراموش میکنه فایل تبدیل شده رو به پوشه اصلی پروژه منتقل کنه. این موضوع باعث میشه پروژه چند جای پراکنده داشته باشه و نظم مسیرهای import بههم بخوره. برای همین مدیریت فایلها همیشه به معنی قرار دادن تمام فایلهای .py داخل یک ساختار مشخصه.
اگه در پروژه نیاز باشه چند فایل .py برای مدیریت کد ساخته بشه، بهتره با توجه به نقش هر فایل، اونها رو یا در ریشه پروژه قرار بدیم، یا داخل پوشههای فرعی. برای مثال پروژهای که چند بخش مستقل داره ممکنه اینطوری سازماندهی بشه:
Location
1
C:.
2
└───project
3
├───main.py
4
├───core
5
│ └───auth.py
6
│ └───database.py
7
└───utils
8
└───formatter.py
اینجا مدیریت فایلهای پایتون نه فقط روی ترتیب فایلها بلکه روی ساختار import و نحوه توسعه پروژه اثر داره. برای همین در این داکیومنت پایتون تأکید میشه که مراحل ایجاد فایل Python برای نوشتن کد پایتون باید با یک ساختار منظم همراه باشه تا در ادامه پروژه گسترش پیدا کنه بدون اینکه آشفتگی ایجاد بشه.
در نهایت مدیریت فایلهای .py در پوشه پروژه پایتون یعنی:
- انتخاب محل مناسب ذخیره فایلهای Python
- رعایت اصول نام گذاری فایل پایتون
- قرار دادن فایلها در مسیرهای مشخص و قابل فهم
- توجه به سازگاری پوشهها با ساختار import
- استفاده از ابزارهایی مثل VS Code برای نمایش بهتر فایلها
- نگه داشتن تمام اسکریپتها در یک نقطه مرکزی برای جلوگیری از پراکندگی
وقتی ساخت فایل py و ساخت اولین اسکریپت پایتون با فایل .py انجام میشه، معمولاً همه چیز داخل یک فایل مثل main.py نوشته میشه. اما به محض اینکه پروژه کمی بزرگتر میشه، نگه داشتن همه کدها داخل یک فایل باعث شلوغی، سختی درک و دشوار شدن مدیریت فایلهای پایتون میشه. اینجاست که مفهوم ساخت چند فایل .py برای سازماندهی کدها مطرح میشه.
وقتی چند فایل .py کنار هم قرار میگیرن، هر کدوم میتونن نقش یک ماژول رو داشته باشن. به این ترتیب پروژه به بخشهای منطقی تقسیم میشه، مثلاً یک فایل برای منطق اصلی، یک فایل برای توابع کمکی، یک فایل برای کار با دیتابیس و الی آخر.
فرض کنین پروژه این ساختار رو داشته باشه:
Location
1
C:.
2
└───project
3
├───main.py
4
├───utils.py
4
└───calculator.py
در این حالت، به جای اینکه همه توابع داخل main.py نوشته بشه، توابع مربوط به محاسبات داخل calculator.py قرار میگیرن:
calculator.py
1
# calculator.py
2
def add(a, b):
3
return a + b
و بعد در فایل اصلی import میشن:
main.py
1
# main.py
2
from calculator import add
3
4
result = add(5, 3)
5
print(result)
اینجا دقیقاً نحوه ایجاد چند فایل .py برای مدیریت کدهای پایتون رو میبینین. هر فایل مسئول یک بخش مشخص هست و پروژه خواناتر میشه.
از نظر عملی، ساخت فایل پایتون در VS Code یا ایجاد فایل Python در Visual Studio Code برای این کار خیلی سادهست. داخل پوشه پروژه روی New File کلیک میکنین، اسم فایل جدید رو مثلاً utils.py میزاریم و ذخیره فایل پایتون انجام میشه. مهمه که این فایلها داخل همون محل مناسب ذخیره فایلهای Python در پروژه ساخته بشن، نه بیرون از پوشه اصلی.
اگه با ترمینال کار میکنین، ساخت فایل پایتون از طریق ترمینال ویندوز هم همین مفهوم رو داره. مثلاً داخل پوشه پروژه:
Bash
1
type nul > utils.py
2
type nul > services.py
این یعنی عملاً داریم پروژه رو به چند اسکریپت جدا تقسیم میکنیم.
نکته مهم اینجاست که نام گذاری فایل پایتون در این مرحله اهمیت بیشتری پیدا میکنه. طبق روش نام گذاری صحیح فایلهای .py در پایتون بهتره اسمها کوتاه، با حروف کوچک و بدون فاصله باشن، مثل:
data_handler.py
auth_service.py
file_utils.py
این کار باعث میشه هم import ها تمیز باشن، هم توسعه پروژه در آینده سادهتر بشه.
معمولاً توصیه میشه که هر فایل فقط یک مسئولیت مشخص داشته باشه. مثلاً:
- main.py برای اجرای برنامه
- config.py برای تنظیمات
- models.py برای ساختار دادهها
- utils.py برای توابع عمومی
این نوع تقسیمبندی باعث میشه وقتی اجرای فایل py انجام میشه، ساختار پروژه قابل فهم باشه و توسعهدهندههای دیگه هم سریعتر پروژه رو درک کنن.