کدچ
برای اجرای درست پایتون در ویندوز، سه چیز باید به هم وصل باشند: مفسر نصب‌شده، فایل برنامه و مفسری که ویرایشگر انتخاب کرده است. نصب افزونهٔ Python در VS Code به‌تنهایی مفسر را نصب نمی‌کند. اگر برنامه در ترمینال کار می‌کند اما در ویرایشگر خطا می‌دهد، نخست مسیر مفسر را مقایسه کنید.
قبل از نصب دوباره، وضعیت فعلی را ببینید
در PowerShell این دستورها را جداگانه اجرا کنید:
python --version
Get-Command python -ErrorAction SilentlyContinue
py --version
ممکن است فقط یکی از python یا py در دسترس باشد. پیدا نشدن یکی الزاماً به معنی نبود پایتون نیست. اگر اجرای python شما را به فروشگاه ویندوز می‌برد، مسیر شناسایی‌شده و تنظیمات App execution aliases را بررسی کنید. حذف یا تغییر تصادفی PATH روش مناسبی برای تشخیص مشکل نیست.
برای دریافت مفسر از وب‌سایت رسمی پایتون استفاده کنید. ظاهر نصب‌کننده و ابزار مدیریت نسخه‌ها با نسخهٔ پایتون تغییر می‌کند؛ اصل ثابت این است که پس از نصب، نسخه و مسیر مفسر را از داخل همان محیط اجرای برنامه بررسی کنید. مثال‌های این مجموعه بر مبنای Python 3.11 به بالا نوشته شده‌اند؛ وابستگی‌های هر مقاله جدا مشخص می‌شوند.
یک پروژهٔ کوچک و قابل تشخیص بسازید
پوشه‌ای مانند python-practice بسازید و همان پوشه را در VS Code باز کنید. فایل hello.py را با این محتوا ذخیره کنید:
import sys
print("Hello, Codech!")
print(sys.executable)
print(sys.version.split()[0])
خط اول یک پیام ثابت می‌دهد. خط دوم مسیر دقیق مفسر را نمایش می‌دهد؛ مسیر برای دستگاه شما متفاوت است. خط سوم نسخهٔ اجراکننده را نشان می‌دهد. این اطلاعات را با دستور python hello.py در ترمینال مقایسه کنید. اگر فایل ذخیره نشده باشد، ممکن است نسخهٔ قبلی آن اجرا شود.
انتخاب مفسر در VS Code
افزونهٔ رسمی Python از Microsoft را نصب کنید. از Command Palette دستور Python: Select Interpreter را باز کنید و همان مفسری را انتخاب کنید که برای پروژه می‌خواهید. سپس ترمینال تازه‌ای باز کنید و فایل را دوباره اجرا کنید. ترمینال قدیمی ممکن است هنوز تنظیمات محیط قبلی را داشته باشد.
وجود چند نسخهٔ پایتون عادی است. مسئله وقتی ایجاد می‌شود که بسته را در یکی نصب کنید و برنامه را با دیگری اجرا کنید. برای همین، دستور python -m pip قابل پیگیری‌تر از اجرای تنها pip است: pip را به همان python متصل می‌کند.
محیط مجازی بدون تغییر تنظیمات امنیتی PowerShell
برای هر پروژه محیط مستقلی بسازید:
python -m venv .venv
.\.venv\Scripts\python.exe hello.py
.\.venv\Scripts\python.exe -m pip --version
این روش به فعال‌کردن محیط نیاز ندارد. اگر اجرای Activate.ps1 محدود شده، برای اجرای مثال‌ها مجبور نیستید ExecutionPolicy را در کل سیستم عوض کنید. در VS Code هم می‌توانید مفسر داخل .venv را انتخاب کنید.
چهار نشانهٔ مشکل و محل بررسی
| نشانه | بررسی اول |
|---|---|
| فایل پیدا نمی‌شود | پوشهٔ فعلی ترمینال و نام واقعی فایل |
| بسته در یک محیط پیدا نمی‌شود | مقایسهٔ sys.executable و python -m pip --version |
| متن فارسی ناخوانا است | ذخیرهٔ UTF-8، فونت ترمینال و اجرای python -X utf8 |
| تغییر کد در خروجی دیده نمی‌شود | ذخیرهٔ فایل و اطمینان از اجرای همان مسیر |
فایلی به نام json.py یا random.py کنار تمرین‌ها نسازید؛ ممکن است جای ماژول استاندارد هم‌نام وارد شود. این مشکل شبیه خرابی نصب به نظر می‌رسد، ولی با تغییر نام فایل خودتان حل می‌شود.
تمرین و گفت‌وگو
فایل بالا را یک بار با ترمینال و یک بار با دکمهٔ اجرای VS Code اجرا کنید. اگر مسیرها متفاوت‌اند، نام نسخه‌ها و متن خطا را در دیدگاه بگذارید. مسیر شخصی را می‌توانید کوتاه کنید؛ برای تشخیص به نام کاربری ویندوز شما نیازی نیست.
منابع و ادامهٔ یادگیری
این آموزش بر پایهٔ پایتون مقدماتی ۱ آکادمی کدچ، فصل ۱: نصب، ویرایشگر و نخستین اجرا، و مثال‌های بازنویسی‌شده برای این مقاله تدوین شده است.
برای ادامهٔ تمرین، دوره‌های آموزش پایتون آکادمی کدچ را ببینید. در بخش دیدگاه همین مقاله می‌توانید پرسش و نمونهٔ کوچک کد خود را مطرح کنید.
گفت‌وگو دربارهٔ این مطلب
هنوز دیدگاهی منتشر نشده است.
برای ثبت دیدگاه وارد حساب کاربری شوید.
