چگونه کتابخانه پایتون را نصب کنیم؟

نصب کتابخانه پایتون با استفاده از PIP

برای نصب کتابخانه‌های پایتون، از ابزار PIP که مدیریت بسته‌های پایتون را بر عهده دارد، استفاده می‌شود. این ابزار به شما امکان می‌دهد که کتابخانه‌های مختلف را به‌راحتی نصب، به‌روزرسانی یا حذف کنید.

بررسی نصب بودن PIP

برای اطمینان از اینکه PIP روی سیستم شما نصب شده است، در ترمینال یا خط فرمان این دستور را اجرا کنید:

pip –version

اگر خروجی‌ای مشابه pip 23.0.1 from ... دریافت کردید، یعنی PIP نصب است. در غیر این صورت، باید آن را نصب کنید.

نصب PIP در صورت نبودن

در نسخه‌های جدید پایتون، PIP به‌صورت پیش‌فرض نصب است. اگر نصب نیست، بسته به سیستم‌عامل خود یکی از روش‌های زیر را استفاده کنید:

• در ویندوز: python -m ensurepip --default-pip
• در لینوکس (Ubuntu/Debian): sudo apt install python3-pip
• در macOS (با Homebrew): brew install python3

نصب کتابخانه با استفاده از PIP

برای نصب یک کتابخانه، از این دستور استفاده کنید:

pip install نام_کتابخانه

به‌عنوان مثال، برای نصب کتابخانه NumPy:

pip install numpy

نصب نسخه خاصی از یک کتابخانه

در صورتی که نیاز به نسخه خاصی از یک کتابخانه داشته باشید، از این دستور استفاده کنید:

pip install نام_کتابخانه==شماره_نسخه

مثلاً برای نصب نسخه 1.3.0 از pandas:

pip install pandas==1.3.0

نصب چندین کتابخانه به‌صورت هم‌زمان

در پروژه‌هایی که نیاز به چندین کتابخانه دارید، می‌توانید همه را در یک فایل متنی به نام requirements.txt ذخیره کرده و به‌صورت گروهی نصب کنید.

1. ایجاد فایل requirements.txt و نوشتن نام کتابخانه‌ها در آن، مانند:
   numpy
   pandas
   matplotlib
2. اجرای دستور:

pip install -r requirements.txt

به‌روزرسانی یک کتابخانه

برای آپدیت یک کتابخانه به آخرین نسخه موجود، از این دستور استفاده کنید:

pip install –upgrade نام_کتابخانه

مثلاً برای به‌روزرسانی scikit-learn:

pip install –upgrade scikit-learn

حذف یک کتابخانه

اگر دیگر به یک کتابخانه نیاز ندارید، می‌توانید آن را حذف کنید:

pip uninstall نام_کتابخانه

مثلاً برای حذف matplotlib:

pip uninstall matplotlib

مشاهده کتابخانه‌های نصب‌شده

برای دریافت لیست تمام کتابخانه‌های نصب‌شده، این دستور را اجرا کنید:

pip list

بررسی اطلاعات یک کتابخانه

برای مشاهده اطلاعات یک کتابخانه، مانند نسخه نصب‌شده و توضیحات، از این دستور استفاده کنید:

pip show نام_کتابخانه

مثلاً برای مشاهده اطلاعات Flask:

pip show flask

رفع مشکلات رایج در PIP

اگر با خطای "pip command not found" مواجه شدید، مسیر C:\Python\Scripts\ را در ویندوز به متغیر PATH اضافه کنید.
در صورت دریافت خطای Permission Denied در لینوکس، دستورات را با sudo اجرا کنید.

جمع‌بندی

PIP ابزاری ضروری برای نصب و مدیریت کتابخانه‌های پایتون است که به شما کمک می‌کند کتابخانه‌های موردنیاز را به‌راحتی نصب، به‌روزرسانی و حذف کنید. استفاده از PIP باعث می‌شود کدهای شما سریع‌تر و بهینه‌تر اجرا شوند.

رفع خطاهای رایج هنگام نصب کتابخانه‌های پایتون

گاهی هنگام نصب کتابخانه‌های پایتون، با خطاهایی مواجه می‌شوید که می‌توانند به دلایل مختلفی از جمله عدم دسترسی، ناسازگاری نسخه‌ها یا مشکلات اینترنتی رخ دهند. در اینجا، رایج‌ترین خطاهای PIP و روش‌های رفع آن‌ها را بررسی می‌کنیم.

1. خطای “pip: command not found” یا “pip is not recognized”

این خطا نشان می‌دهد که PIP روی سیستم شما نصب نیست یا مسیر آن در متغیرهای محیطی (PATH) تنظیم نشده است.

راه‌حل:

• بررسی کنید که PIP نصب است با اجرای دستور python -m ensurepip --default-pip
• اگر نصب نیست، آن را نصب کنید. در ویندوز با اجرای python -m ensurepip و در لینوکس با sudo apt install python3-pip
• در صورت حل نشدن مشکل، مسیر C:\Python\Scripts\ را به متغیر PATH اضافه کنید.

2. خطای “Could not find a version that satisfies the requirement”

این خطا معمولاً به دلیل اشتباه در نام کتابخانه، ناسازگاری نسخه پایتون یا مشکلات اینترنتی رخ می‌دهد.

راه‌حل:

• بررسی کنید که نام کتابخانه را درست وارد کرده‌اید.
• نسخه پایتون خود را بررسی کنید با دستور python --version.
• در صورت نیاز، پایتون یا PIP را به‌روز کنید. در ویندوز با python -m pip install --upgrade pip
• اگر مشکل حل نشد، از سرورهای PyPI جایگزین استفاده کنید:
  pip install package_name --index-url=https://pypi.org/simple

3. خطای “Permission Denied” هنگام نصب کتابخانه‌ها

این خطا معمولاً به دلیل عدم دسترسی کافی در ویندوز یا لینوکس رخ می‌دهد.

راه‌حل:

• در ویندوز، خط فرمان (CMD) را به‌صورت Administrator اجرا کنید و سپس نصب را انجام دهید.
• در لینوکس و مک، دستور را با sudo اجرا کنید: sudo pip install نام_کتابخانه
• برای نصب بدون دسترسی مدیریتی، از pip install --user نام_کتابخانه استفاده کنید.

4. خطای “SSL Certificate Verify Failed” هنگام دانلود بسته‌ها

این خطا معمولاً به دلیل مشکلات گواهی SSL هنگام اتصال به PyPI رخ می‌دهد.

راه‌حل:

• PIP را به‌روز کنید: python -m pip install --upgrade pip
• هنگام نصب، پارامتر --trusted-host را اضافه کنید:
  pip install نام_کتابخانه --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org
• گواهی‌های SSL را آپدیت کنید: python -m certifi

5. خطای “No module named ‘pip'”

این خطا به این معنی است که PIP روی سیستم نصب نیست یا به درستی پیکربندی نشده است.

راه‌حل:

• بررسی کنید که پایتون به‌درستی نصب شده است: python --version
• سعی کنید PIP را مجدداً نصب کنید: python -m ensurepip --default-pip
• در صورت حل نشدن مشکل، نصب دستی را امتحان کنید:
  curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

6. خطای “ModuleNotFoundError” پس از نصب کتابخانه

این خطا نشان می‌دهد که کتابخانه نصب شده است، اما در محیط درستی اجرا نمی‌شود.

راه‌حل:

• بررسی کنید که پایتون از مسیر درستی اجرا می‌شود با which python.
• بررسی کنید که کتابخانه در مسیر درست نصب شده است با pip show نام_کتابخانه.
• اگر از محیط مجازی (Virtual Environment) استفاده می‌کنید، ابتدا آن را فعال کنید:
  source venv/bin/activate در لینوکس و مک
  venv\Scripts\activate در ویندوز

7. خطای “Could not install packages due to an OSError: [Errno 13] Permission denied”

این خطا معمولاً به دلیل عدم اجازه نوشتن در مسیر نصب کتابخانه‌ها رخ می‌دهد.

راه‌حل:

• به جای نصب سیستمی، از نصب محلی (User Installation) استفاده کنید:
  pip install --user نام_کتابخانه
• اگر مشکل حل نشد، از محیط مجازی استفاده کنید:
  python -m venv myenv
source myenv/bin/activate در لینوکس و مک
  myenv\Scripts\activate در ویندوز
  سپس نصب را انجام دهید.

8. خطای “Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))”

این خطا معمولاً به دلیل اتصال ضعیف به اینترنت یا تحریم‌های منطقه‌ای است.

راه‌حل:

• از VPN یا پراکسی برای اتصال به PyPI استفاده کنید.
• می‌توانید از سرورهای آینه‌ای PyPI استفاده کنید:
  pip install نام_کتابخانه --index-url=https://pypi.org/simple

جمع‌بندی

• مشکلات مربوط به نصب PIP را می‌توان با ensurepip یا نصب دستی حل کرد.
• مشکلات دسترسی و مجوزها را می‌توان با sudo یا نصب محلی --user برطرف کرد.
• مشکلات مربوط به SSL و اینترنت را می‌توان با --trusted-host و تغییر سرورهای آینه‌ای حل کرد.
• خطاهای مربوط به عدم شناسایی کتابخانه‌ها را می‌توان با بررسی محیط مجازی یا مسیر نصب حل کرد.