نصب پایتون در ویندوز با دریافت ابزار رسمی، انتخاب مفسر سازگار و آزمون اجرای آن انجام می‌شود. برای شروع برنامه‌نویسی، لازم نیست همهٔ ابزارهای آزمایش و اشکال‌زدایی CPython را نصب کنید. هدف این راهنما، یک محیط روشن برای اجرای پروژه و مدیریت وابستگی‌هاست.
وضعیت Windows 10 و پیش‌نیازها
پشتیبانی عمومی Windows 10 در ۱۴ اکتبر ۲۰۲۵ پایان یافته است؛ برخی ویرایش‌ها یا دستگاه‌های دارای ESU وضعیت متفاوت دارند. چرخهٔ پشتیبانی مایکروسافت را برای دستگاه خود بررسی کنید. نصب نسخهٔ تازهٔ پایتون، مشکل پشتیبانی امنیتی سیستم‌عامل را برطرف نمی‌کند.
در رایانهٔ سازمانی، روش نصب باید با سیاست مدیر هماهنگ باشد. داشتن دسترسی Administrator برای تمام نصب‌های شخصی لازم نیست. همچنین Python همراه بعضی ابزارهای دیگر را بدون شناخت وابستگی آن ابزار حذف نکنید.
روش فعلی نصب پایتون در ویندوز
مستند رسمی Python برای ویندوز، Python Install Manager را از python.org یا Microsoft Store معرفی می‌کند. بستهٔ رسمی را نصب و یک ترمینال تازه باز کنید. برای مدیریت نسخه‌ها، فرمان pymanager احتمال تداخل با launcher قدیمیِ py را کمتر می‌کند.
pymanager list --online
pymanager install 3.14
pymanager list
py -V:3.14 --versionشمارهٔ ۳٫۱۴ نمونهٔ مشخص است، نه ادعای «آخرین نسخه برای همیشه». نسخهٔ پایدار سازگار با پروژه را از فهرست انتخاب کنید. اگر py به راه‌انداز قدیمی اشاره می‌کند، ابتدا مسیر و نصب‌های موجود را بررسی کنید؛ تغییر تصادفی PATH می‌تواند ابزارهای دیگر را مختل کند.
ساخت محیط مستقل برای پروژه
در پوشهٔ پروژهٔ تازه، نمونهٔ زیر برای مفسر انتخاب‌شده است:
py -V:3.14 -m venv .venv
..venvScriptspython.exe --version
..venvScriptspython.exe -m pip --version
..venvScriptspython.exe -c "import sys; print(sys.executable)"این روش مستقیم در PowerShell به اجرای اسکریپت فعال‌سازی نیاز ندارد. بنابراین برای آغاز کار لازم نیست سیاست اجرای اسکریپت‌های ویندوز را تغییر دهید. طبق مرجع venv، می‌توان مفسر داخل محیط را مستقیماً فراخواند.
اگر پروژه requirements.txt معتبر دارد، وابستگی‌ها را برای همین مفسر نصب کنید:
..venvScriptspython.exe -m pip install -r requirements.txtاگر چنین فایلی وجود ندارد، این دستور را اجرا نکنید. ابتدا فایل وابستگی‌های پروژه را مشخص کنید. نصب یک کتابخانه با pip مربوط به مفسر دیگر، علت رایج خطای ModuleNotFoundError است.
آزمون یک برنامهٔ ساده
فایل hello.py را در پوشهٔ پروژه، بیرون از .venv، با محتوای زیر ذخیره کنید:
print("Hello, Hostnegar!")سپس اجرا کنید:
..venvScriptspython.exe hello.pyنام فایل نباید ناخواسته hello.py.txt شده باشد. نمایش پیام مورد انتظار، اجرای مفسر و فایل را تأیید می‌کند؛ برای پروژهٔ واقعی هنوز باید آزمون‌های همان برنامه اجرا شوند.
رفع مشکل PATH و انتخاب مفسر در ویرایشگر
اگر python پیدا نمی‌شود یا Store باز می‌شود، در تنظیمات ویندوز بخش Manage app execution aliases و نصب مدیر پایتون را بررسی کنید. اگر ترمینال قبل از نصب باز بوده، یک پنجرهٔ تازه امتحان کنید. مسیر یک کاربر دیگر یا پوشهٔ حدسی Python310 را به PATH اضافه نکنید.
در ویرایشگر، مفسر .venv همین پروژه را انتخاب کنید و مسیر sys.executable را با ترمینال تطبیق دهید. برای انتقال پروژه، کد و فهرست وابستگی‌ها را نگه دارید و محیط را در مقصد دوباره بسازید؛ کپی سادهٔ پوشهٔ محیط، روش قابل اتکای انتقال میان رایانه‌ها نیست.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
