M1-P1 · إعداد بيئة العمل وأول سكريبت

تثبيت بايثون واختيار المحرر المناسب



إعداد بيئة العمل: تثبيت Python واختيار المحرر

بصفتك مهندس AI مبتدئ، تحتاج إلى بيئة تطوير نظيفة وقوية. سنقوم بإعداد أساسيات العمل باستخدام Python و VS Code.

1. تثبيت Python

التنزيل الصحيح لـ Python هو الخطوة الأهم.

لـ Windows:
1. ادخل إلى الموقع الرسمي: python.org/downloads.
2. حمّل أحدث إصدار مستقر (مثلاً 3.11.x أو 3.12.x).
3. خطوة حاسمة: عند تشغيل المثبت، تأكد من تحديد الخيار "Add Python to PATH" في أسفل الشاشة قبل الضغط على "Install Now".
- لماذا؟: هذا يسمح لنظام التشغيل بالعثور على أمر python من أي مكان في الطرفية (Terminal) دون كتابة المسار الكامل.

لـ macOS / Linux:
غالباً ما يكون Python مثبتاً مسبقاً، لكن ننصح باستخدام مدير حزم مثل Homebrew (للماك) للتأكد من وجود أحدث إصدار:

# مثال لـ macOS باستخدام Homebrew
brew install python

التحقق من التثبيت:
افتح الطرفية (Terminal) أو Command Prompt واكتب:

python --version

أو في بعض الأنظمة:

python3 --version

يجب أن يظهر رقم الإصدار (مثلاً Python 3.11.5).

2. اختيار محرر الكود: VS Code

Visual Studio Code (VS Code) هو الخيار الأمثل لمهندسي AI بسبب خفته ودعمه الواسع للإضافات.

  1. حمّله من: code.visualstudio.com.
  2. ثبّته بالطريقة المعتادة.
  3. افتح VS Code، ثم ادخل إلى Extensions (الأيقونة المربعة على الشريط الجانبي).
  4. ابحث عن "Python" من ناشر Microsoft وقم بتثبيتها.
    - هذه الإضافة توفر: Autocomplete، تلوين الكود، وأدوات للتصحيح (Debugging).

3. إنشاء أول مجلد مشروع

لا تكتب كوداً عشوائياً. أنشئ مجلداً خاصاً بمشروعك:

  1. أنشئ مجلداً جديداً على سطح المكتب باسم ai_project.
  2. افتح VS Code واختر File > Open Folder واختر ai_project.
  3. أنشئ ملفاً جديداً باسم main.py.

اكتب هذا الكود البسيط للتأكد من عمل البيئة:

# main.py
print("مرحباً، بيئة AI جاهزة!")

# طباعة معلومات النظام
import sys
print(f"إصدار Python: {sys.version}")

شغّل الكود بالضغط على زر التشغيل (Play) في الأعلى الأيمن، أو عبر الطرفية:

python main.py

4. تثبيت الحزم الأساسية (Pip)

أداة pip تأتي مثبتة مع Python وهي تُستخدم لتحميل المكتبات. كمهندس AI، ستحتاج غالباً إلى مكتبات مثل numpy و pandas.

لتثبيت حزمة، استخدم الأمر:

pip install numpy

نصيحة احترافية:
استخدم Virtual Environments لعزل كل مشروع. هذا يمنع تعارض إصدارات الحزم بين المشاريع المختلفة.

# إنشاء بيئة افتراضية باسم venv
python -m venv venv

# تفعيل البيئة
# لـ Windows:
venv\Scripts\activate
# لـ macOS/Linux:
source venv/bin/activate

بعد التفعيل، ستلاحظ ظهور (venv) في بداية سطر الأوامر. الآن أي حزمة تثبّتها ستبقى داخل هذا المجلد فقط.

أخطاء شائعة أثناء التثبيت

الخطأ السبب الحل
'python' is not recognized... لم يتم إضافة Python إلى PATH أثناء التثبيت. أعد تثبيت Python وتأكد من اختيار "Add to PATH"، أو أعد تشغيل الحاسوب بعد التثبيت.
ModuleNotFoundError الحزمة غير مثبتة في البيئة الحالية. تأكد من تفعيل الـ Virtual Environment ثم ثبّت الحزمة عبر pip install <name>.
أخطاء صلاحيات (Permission denied) محاولة التثبيت في مدير النظام دون صلاحيات. استخدم pip install --user <package> أو فعّل الـ Virtual Environment.

خلاصة

  1. ثبّت Python وتأكد من خيار Add to PATH.
  2. استخدم VS Code مع إضافة Python الرسمية.
  3. أنشئ Virtual Environment لكل مشروع جديد لعزل الحزم.
  4. تحقق دائماً من الإصدار عبر python --version.