الطرفية، المجلدات، ومشروعك الأول

المشكلة التي نقوم بحلها

في المهمة السابقة قمت بتثبيت بايثون وتشغيل أول ملف. لكن حدث شيء مهم دون أن تلاحظه — قبل تشغيل الملف، كان عليك الانتقال إلى مجلده عبر الطرفية (Terminal).

هذا "الانتقال" هو أكثر ما يوقع المبتدئين في الحيرة والارتباك. الكود سليم، وبايثون مثبت بشكل صحيح، لكن الطرفية تقف داخل مجلد آخر — فيخبرك بايثون أن الملف غير موجود.

في بيئة العمل ستكرر هذه العملية مئات المرات يومياً. لذا سنحول اليوم الطرفية من شاشة سوداء مجهولة إلى أداة أساسية تتقن استخدامها.

بنهاية هذه المهمة ستكون قادراً على

• معرفة المجلد الذي تقف فيه الطرفية حالياً
• التنقل بين المجلدات والرجوع خطوة إلى الخلف
• إنشاء مجلد مشروع وتشغيل ملف بداخله
• فتح وإغلاق بيئة بايثون التفاعلية (REPL)
• فهم الفرق الجوهري بين بيئة REPL وملف .py

المتطلبات المسبقة: تثبيت بايثون وتشغيل برنامجك الأول.

ما هي الطرفية فعلياً؟

الطرفية هي المكان الذي تصدر فيه الأوامر للحاسوب عبر الكتابة بدلاً من النقر بالماوس. وكل نافذة طرفية تقف دائماً داخل مجلد محدد يسمى المجلد الحالي (Current Directory).

عندما تكتب python hello.py، فأنت تقول عملياً: "شغّل ملف `hello.py` الموجود في المجلد الذي أقف فيه الآن." إذا كان الملف في مجلد آخر، فلن يجده بايثون لأنه لا يبحث في مكان آخر.

عند فتح PowerShell، ستشاهد عادة سطراً يشبه:

PS C:\Users\Rafi>

الجزء C:\Users\Rafi يخبرك بمكانك الحالي.

أربعة أوامر تغطي معظم احتياجاتك

pwd — أين أنا الآن؟

pwd

Path
----
C:\Users\Rafi

dir — ماذا يوجد هنا؟

dir

يقوم هذا الأمر بعرض قائمة الملفات والمجلدات. كتابة dir قبل تشغيل الملف ممارسة جيدة للتأكد من وجود الملف فعلياً.

cd — الانتقال إلى مجلد آخر

cd D:\python-lab

نقطتان (..) تعنيان الرجوع خطوة واحدة للأعلى:

cd ..

mkdir — إنشاء مجلد جديد

mkdir lesson-02

إعداد مجلد المشروع

احرص على تنظيم ملفاتك داخل مجلد رئيسي بدلاً من نثرها عشوائياً:

cd D:\
mkdir python-lab
cd python-lab
mkdir lesson-02
cd lesson-02
pwd

يجب أن تكون النتيجة:

Path
----
D:\python-lab\lesson-02

أنشئ الآن ملفاً باسم notes.py داخل هذا المجلد واكتب بداخله:

print("Folder:", "lesson-02")
print("Squares:", 2 * 2, 3 * 3, 4 * 4)

وشغله عبر الأمر:

python notes.py

Folder: lesson-02
Squares: 4 9 16

بيئة بايثون التفاعلية (REPL)

اكتب في الطرفية كلمة python فقط واضغط Enter:

python

Python 3.12.0 (tags/v3.12.0) on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>

رمز >>> يعني أن مفسر بايثون ينتظر منك سطراً برمجياً لينفذه فوراً:

>>> 2 + 3
5
>>> "Python"
'Python'
>>> len("terminal")
8

تسمى هذه البيئة REPL (Read, Evaluate, Print, Loop). وهي ممتازة لاختبار العمليات الحسابية أو تجربة دالة معينة بسرعة.

للخروج منها اكتب:

>>> exit()

الفرق الجوهري الذي يسبب الكثير من الارتباك: في بيئة REPL، كتابة 2 + 3 تُظهر النتيجة 5 تلقائياً على الشاشة. أما داخل ملف كود .py، فإن كتابة 2 + 3 وحدها لا تُظهر أي شيء — لأن بايثون ينفذ العملية بصمت؛ ولإظهار النتيجة على الشاشة يجب عليك استخدام دالة print.

أخطاء شائعة وكيفية حلها

ظهور خطأ can't open file: No such file or directory الطرفية تقف في مجلد غير الذي يحتوي على الملف. استخدم pwd للتأكد من مسارك الحالي، ثم dir للتحقق من وجود الملف.

الطرفية متوقفة وتُظهر فقط رمز >>> أنت حالياً داخل بيئة REPL التفاعلية. أوامر الطرفية مثل dir أو python notes.py لن تعمل هنا لأنها ليست أكواد بايثون. اكتب exit() للعودة إلى سطر أوامر النظام.

دورك الآن

باستخدام أوامر الطرفية فقط:

1. أنشئ مجلداً باسم practice داخل D:\python-lab
2. انتقل إليه وتحقق باستخدام pwd
3. أنشئ بداخله ملفاً باسم about.py يطبع اسمك وتاريخ اليوم
4. شغّله عبر الأمر python about.py
5. الآن اكتب cd .. للرجوع خطوة واحدة للأعلى وشغّل python about.py مجدداً — ماذا حدث؟

ملاحظة سبب الخطأ في الخطوة الخامسة هي الدرس الحقيقي الذي سيوفر عليك ساعات طويلة لاحقاً.