مقدمات و راه‌اندازی

برنامه‌نویسی پایتون در VS Code

۳ دقیقه مطالعه · به‌روزرسانی ۲۲ مهر ۱۴۰۵

Visual Studio Code یک ویرایشگر کد رایگان، سبک و چندسکویی است که با افزونه‌ها به یک محیط کامل پایتون تبدیل می‌شود. برای پروژه‌های واقعی (چند فایل، گیت، دیباگ) معمولاً از Jupyter مناسب‌تر است، و جالب اینکه نوت‌بوک‌های Jupyter را هم داخل خودش اجرا می‌کند.

نصب و افزونه‌ها

1. VS Code را از code.visualstudio.com دانلود و نصب کنید.
2. از نوار کناری، بخش Extensions (Ctrl+Shift+X) را باز کنید و این‌ها را نصب کنید:
   • Python (ناشر Microsoft) — تکمیل خودکار، بررسی خطا و اجرای کد. افزونه‌های Pylance و Python Debugger هم همراهش نصب می‌شوند.
   • Jupyter (ناشر Microsoft) — برای اجرای فایل‌های ‎.ipynb‎.
   • پیشنهادی: Ruff یا Black Formatter برای مرتب‌کردن خودکار کد.

پیش از این مرحله باید خود پایتون را نصب کرده باشید؛ VS Code فقط ویرایشگر است و مفسر را همراه ندارد.

باز کردن پروژه و انتخاب مفسر

همیشه پوشه را باز کنید، نه یک فایل تنها: File › Open Folder. سپس:

1. با Ctrl+Shift+P پالت فرمان را باز کنید.
2. فرمان Python: Create Environment را بزنید و Venv را انتخاب کنید. VS Code پوشهٔ ‎.venv‎ را می‌سازد و فعالش می‌کند.
3. اگر محیط از قبل وجود دارد، با Python: Select Interpreter آن را انتخاب کنید.

نسخهٔ مفسر انتخاب‌شده در نوار پایین (Status Bar) دیده می‌شود. اگر کتابخانه‌ای نصب کرده‌اید ولی خطای ModuleNotFoundError می‌گیرید، تقریباً همیشه مفسر اشتباهی انتخاب شده است.

اجرای کد

یک فایل main.py بسازید:

def area(r):
    return 3.14159 * r ** 2

for r in [1, 2, 3]:
    print(f"شعاع {r} → مساحت {area(r):.2f}")

سه راه اجرا:

دیباگ کردن

دیباگر یعنی اجرای کد قدم‌به‌قدم و دیدن مقدار متغیرها در هر لحظه؛ مهارتی که زمان رفع خطا را چند برابر کم می‌کند.

1. روی شمارهٔ خطی که می‌خواهید اجرا آنجا متوقف شود کلیک کنید (یا F9) تا نقطهٔ قرمز Breakpoint بگذارید.
2. F5 را بزنید و Python File را انتخاب کنید.
3. با F10 خط بعد، با F11 ورود به تابع، و از پنل Variables مقدار متغیرها را ببینید.

نوت‌بوک Jupyter داخل VS Code

• یک فایل با پسوند ‎.ipynb‎ بسازید یا باز کنید.
• بالا سمت راست، Select Kernel را بزنید و محیط ‎.venv‎ پروژه را انتخاب کنید (اگر لازم باشد، VS Code بستهٔ ipykernel را خودش نصب می‌کند).
• سلول‌ها مثل Jupyter با Shift+Enter اجرا می‌شوند.

یک راه سبک‌تر هم هست: در فایل ‎.py‎ معمولی، خطی با # %% بنویسید تا کد به «سلول» تقسیم شود و بالای هر سلول گزینهٔ Run Cell ظاهر شود. هم مزیت نوت‌بوک را دارید و هم یک فایل پایتون تمیز.

# %%
import math

# %%
print(math.sqrt(2))

تنظیمات پیشنهادی

در Settings (Ctrl+,) این‌ها را فعال کنید:

• Format On Save: کد هنگام ذخیره مرتب می‌شود.
• Auto Save: روی afterDelay تا فراموش نکنید ذخیره کنید.
• Python › Analysis: Type Checking Mode روی basic: خطاهای رایج پیش از اجرا علامت می‌خورند.