رفع خطای نصب و اجرای پروژه روی Windows
وقتی یک پروژه یا کتابخانه روی Windows نصب نمیشود یا اجرا نمیشود، لاگ را بده و یک مسیر عیبیابی مرحلهای بگیر، از سادهترین دلیل تا پیچیدهترین، با دستورهای دقیق.
- انتشار
- ۲۶ آبان ۱۴۰۵
- اجرا
- ۳ بار
نمونه خروجی
۱. معنی: Windows دستور pip را پیدا نمیکند؛ یعنی پوشهٔ Scripts پایتون در PATH نیست.
۲. علتها از محتمل به کماحتمال
الف) Python بدون تیک «Add python.exe to PATH» نصب شده.
بررسی: where python
رفع: به جای pip از launcher استفاده کنید:
py -m pip install requests
ب) چند نسخهٔ Python نصب است و pip مال نسخهٔ دیگری است.
بررسی: py -0
رفع: py -3.12 -m pip install requests
ج) نصب ناقص pip.
رفع: py -m ensurepip --upgrade
۳. دامهای Windows
- بعد از تغییر PATH، PowerShell را ببندید و دوباره باز کنید.
- اگر دانلود از PyPI قطع میشود، از یک mirror استفاده کنید:
py -m pip install requests -i <آدرس mirror> --trusted-host <دامنهٔ mirror>
- آنتیویروس گاهی فایلهای .exe در Scripts را قرنطینه میکند.
۴. اگر جواب نداد، خروجی این دو را بفرستید: py -0 و where python
چه چیزی لازم داری
دستوری که زدی، خروجی کامل ترمینال، نسخهٔ Windows و ابزارها
متن پرامپت
پرامپت انگلیسیکدChatGPTI am trying to install or run a project on Windows and it fails.
Command I ran: [command]
Full terminal output:
```
[paste]
```
Environment: Windows [10/11], [Python/Node/other] version [x], shell [PowerShell/cmd/Git Bash], proxy or VPN: [yes/no]
Give me a step-by-step troubleshooting plan:
1. First, say in one line what the output most likely means.
2. Then list causes from most to least likely. For each: how to check it (exact command) and how to fix it (exact command).
3. Call out Windows-specific traps: path length, permissions, antivirus, PATH, line endings, locale/encoding, and network restrictions that may block downloads in my region, with workarounds such as mirrors.
4. Tell me what output to paste back if the first fix does not work.
Explain in Persian, keep commands and error text exactly as they should be typed.بعد از اجرا یا کپی، بگو برایت جواب داد یا نه.
چطور اجرا کنم
- دکمهٔ اجرا را بزن تا پرامپت در jostoju باز شود، یا متن را کپی کن و در ابزار دلخواهت بگذار.
- دستوری که زدی، خروجی کامل ترمینال، نسخهٔ Windows و ابزارها را به آن بده.
- جایخالیهای داخل [ ] را با اطلاعات خودت پر کن.
- اگر نتیجه دقیقاً آن چیزی نبود که میخواستی، یک جمله توضیح اضافه کن و دوباره اجرا کن.
پرامپت انگلیسی؛ مدلها پرامپت انگلیسی را هم با ورودی فارسی خوب میفهمند. کلمهای ناآشنا بود؟ واژهنامه.