با پایتون در Visual Studio Code شروع کنید

شکل ۱. برنامه افزودنی رسمی مایکروسافت برای Python در VS Code، افزونه Pylance linting و type-checking را نیز به همراه دارد.

علاوه بر افزونه‌های Python و Pylance، چندین افزونه دیگر برای توسعه‌دهندگان Python توصیه می‌شود:

• Black Formatter اضافه می کند قالب‌بندی خودکار کد منبع با فرمت‌کننده استاندارد واقعی پایتون، سیاه. برای استفاده از آن نیازی به نصب black در محیط مجازی که در آن کار توسعه خود را انجام می دهید ندارید. برنامه افزودنی همراه با نسخه به روز شده خودش است.
• فرمت‌کننده دیگری برای Python، ruff، به دلیل نوشته شدن به زبان Rust مورد توجه قرار گرفته است و بنابراین بسیار سریعتر از مشکی اجرا می شود. هنوز در مراحل توسعه خود نسبت به black قدمت دارد، بنابراین ممکن است بخواهید به خاطر صحت، به black بچسبید، اما همیشه می توانید نصب کنید و بین دو افزونه جابجا شوید.< /li>
• اگر از Notebook Jupyter با پایتون استفاده می کنید، می توانید پشتیبانی از آن را مستقیماً در VS Code با ژوپیتر.
• اگر در ویندوز هستید و از زیرسیستم ویندوز برای لینوکس برای اجرای کد پایتون خود استفاده می کنید، می توانید از WSL برای انجام مستقیم کار توسعه خود در WSL.
• افزونه پایتون مقرراتی برای کار با محیط های مجازی دارد (به زودی در این مورد بیشتر توضیح خواهیم داد)، اما آنها نسبتاً کم هستند. اگر می‌خواهید مدیریت در مقیاس وسیع‌تری برای محیط‌های پایتون داشته باشید، از Python استفاده کنید. Environment Manager extension—به عملیات پیچیده مانند مدیریت محیط های مبتنی بر Conda یا فعال کردن خودکار venv برای یک جلسه کنسول معین اجازه می دهد.
• به‌طور پیش‌فرض، برنامه افزودنی پایتون برای VS Code دارای ویژگی برای افتتاح یا راه‌اندازی یک پروژه جدید و خالی پایتون نیست. برخی از ابزارهای شخص ثالث مدیریت پروژه Python مانند poetry یا hatch یک فهرست راهنمای پروژه Python و داربست جدید را از خط فرمان راه‌اندازی می‌کنند، اما افزونه Python VS Code هنوز پشتیبانی نمی‌کند. آن توابع به طور مستقیم یک برنامه افزودنی شخص ثالث برای کار با شعر وجود دارد.

برای دستورالعمل‌های راه‌اندازی بیشتر، به آموزش ویدیویی InfoWorld، تنظیم برنامه‌های افزودنی پایتون برای کد Microsoft Visual Studio مراجعه کنید.

نکته

اگر از کد VS برای انواع دیگر پروژه‌هایی که پایتون را شامل نمی‌شوند استفاده می‌کنید، می‌توانید (و باید) افزونه پایتون را برای آن پروژه‌ها غیرفعال کنید. عکس آن نیز صادق است: باید هر افزونه دیگری را که در پروژه های پایتون خود استفاده نمی کنید غیرفعال کنید.

تنظیم یک پروژه Python جدید در VS Code

وقتی یک پروژه پایتون جدید راه اندازی می کنید، معمولاً دو مرحله اساسی وجود دارد:

1. یک دایرکتوری برای نگهداری پروژه ایجاد کنید.
2. در صورت نیاز، یک محیط مجازی برای پروژه ایجاد کنید و الزامات را در آن نصب کنید.

افزونه پایتون برای VS Code به تنهایی قسمت اول را مدیریت نمی کند. دایرکتوری مورد نظر خود را برای پروژه خود ایجاد می کنید، سپس داربست را در آن راه اندازی می کنید و در صورت نیاز آن را با چیزهای دیگر پر می کنید. در تئوری، می‌توانید یک پروژه پایتون را با چیزی جز یک دایرکتوری خالی یا به اندازه یک دایرکتوری با یک فایل main.py (خالی) شروع کنید.

اولین باری که دایرکتوری پروژه را با کد VS باز می‌کنید، با گفتگوی مواجه می‌شوید که از شما می‌پرسد آیا به نویسندگان فایل‌های این فهرست اعتماد دارید یا خیر. روی «بله، به نویسندگان اعتماد دارم» کلیک کنید. این به VS Code می‌داند که دایرکتوری را موقتاً باز نمی‌کنید—می‌خواهید از آن به عنوان دایرکتوری واقعی پروژه استفاده کنید.

اگر از ابزاری مانند hatch یا poetry برای مدیریت پروژه‌ها استفاده می‌کنید، ابتدا قبل از باز کردن، فهرست راهنمای پروژه را با آن ابزارها ایجاد کنید. دایرکتوری در VS Code. این بیشتر به این دلیل است که بهتر است ابتدا این نوع نظافت خانه را از سر راه بردارید تا اینکه با مشکل مواجه شوید. بعد از اینکه کار پیکربندی دستی خارج از VS Code قبلاً انجام شد، پیکربندی پروژه برای VS Code آسانتر است.

شکل ۲. هنگام باز کردن دایرکتوری برای اولین بار با VS Code و پسوند Python، باید تأیید کنید که محتوا قابل اعتماد است.

محیط های مجازی پایتون در VS Code

یکی از موارد کلیدی که افزونه پایتون می تواند برای شما مدیریت کند، مدیریت محیط های مجازی برای پروژه های پایتون است. می‌توانید یک venv برای یک پروژه راه‌اندازی کنید، و بسته به اینکه چگونه چیزها را پیکربندی کرده‌اید، به‌طور خودکار نیازمندی‌های آن را نصب کنید:

1. در پالت فرمان VS Code (Ctrl-Shift-P)، “Python: Create Environment” را انتخاب کنید.
2. یک نوع محیط را انتخاب کنید. این معمولاً venv یا Conda است، محیطی که توسط توزیع Anaconda Python استفاده می‌شود. Conda ظاهر نمی شود مگر اینکه Anaconda را نصب کرده باشید، و اکثر اوقات از venv استفاده می کنید.
3. اگر یک محیط موجود شناسایی شود، به شما این امکان داده می شود که از محیط موجود همانطور که هست استفاده کنید یا آن را حذف کنید و یک محیط جدید ایجاد کنید.
4. یک مترجم انتخاب کنید. پسوند پایتون سعی می کند تمام نمونه های نصب شده پایتون را در سیستم شما شناسایی کند. اگر نسخه پایتونی که می خواهید استفاده کنید نشان داده نمی شود، ممکن است اشتباه نصب شده باشد. به مسیر مترجمی که انتخاب می‌کنید توجه کافی داشته باشید — این امر می‌تواند از سردرگمی زیادی در مورد اینکه کدام مترجم را واقعاً استفاده می‌کنید، نجات دهد. همچنین می‌توانید مسیری به مترجم تایپ کنید.

وقتی این کار را انجام دادید، افزونه پایتون محیط مجازی را ایجاد می‌کند، pip را در venv به‌روزرسانی می‌کند و هر الزامی را که تشخیص می‌دهد نصب می‌کند (به عنوان مثال، از طریق یک فایل pyproject.toml در پروژه). می‌توانید روی برگه Output در پنل کنسول VS Code کلیک کنید تا گزارش‌های مربوط به فرآیند راه‌اندازی را ببینید.

تنظیم یک پروژه Python موجود در VS Code

اگر می خواهید VS Code را برای یک پروژه موجود پایتون تنظیم کنید، معمولاً نیازی به انجام کارهای بیشتری از باز کردن دایرکتوری پروژه در VS Code، دادن مجوزها و انتخاب یک محیط مجازی ندارید. برای آن در صورت نیاز.

انتخاب یک محیط مجازی

وقتی یک پروژه پایتون در VS Code باز است، می توانید آزادانه بین محیط مجازی که برای آن استفاده می کنید جابجا شوید. برای انجام این کار، می توانید:

1. روی نسخه مفسر در سمت راست پایین پنجره VS Code کلیک کنید.
2. در پالت فرمان، “Python: Select Interpreter” را انتخاب کنید.

این لیستی از مفسرهای موجود را به نمایش می‌گذارد – هم در سطح جهانی و هم در هر محیط مجازی که با پروژه شما پیکربندی شده است. باز هم به مسیرهای مترجمان دقت کنید! در غیر این صورت، ممکن است زمانی که یک venv می‌خواهید، یک نمونه جهانی پایتون را انتخاب کنید یا برعکس.

شکل ۳. Python در VS Code به طور خودکار محیط های مجازی را شناسایی می کند و به شما امکان می دهد از بین محیط های موجود انتخاب کنید، یک محیط جدید ایجاد کنید یا یک مسیر را به صورت دستی به یکی ارائه دهید.

قبل از فعال کردن venvs افزونه پایتون را فعال کنید

افزونه Python در VS Code رفتار ظریفی دارد که شامل محیط‌های مجازی می‌شود که اگر از آن آگاه نباشید ممکن است شما را غافلگیر کند.

وقتی یک پروژه پایتون را در VS Code باز می‌کنید، پسوند پایتون تا زمانی که کاری خاص مرتبط با پایتون انجام ندهید فعال نمی‌شود. رایج ترین اقدام در این زمینه باز کردن یک فایل پایتون در پروژه شما است.