سوالات متداول درباره NVM
مشکلات نصب
چرا "nvm به عنوان یک دستور داخلی یا خارجی شناخته نمیشود" دریافت میکنم؟
این خطا زمانی رخ میدهد که Windows نمیتواند دستور nvm را در مسیر سیستم شما پیدا کند. برای رفع:
- پس از نصب کامپیوتر خود را راهاندازی مجدد کنید
- اگر مشکل ادامه دارد، بررسی کنید که مسیر نصب NVM در متغیر محیطی PATH شما باشد:
- Control Panel > System > Advanced system settings > Environment Variables را باز کنید
- بررسی کنید که مسیر NVM (مثلاً
C:\Users\<username>\AppData\Roaming\nvm) در متغیر PATH کاربر باشد
آیا باید قبل از نصب NVM، Node.js را حذف کنم؟
بله، توصیه میشود قبل از نصب NVM برای Windows، تمام نسخههای موجود Node.js را حذف کنید. این به جلوگیری از تداخل احتمالی بین نصب سراسری Node.js و نسخههای مدیریت شده توسط NVM کمک میکند.
چگونه NVM را بدون از دست دادن نسخههای Node.js دوباره نصب کنم؟
اگر نیاز به نصب مجدد NVM دارید اما میخواهید نسخههای Node.js خود را حفظ کنید:
- دایرکتوری
C:\Users\<username>\AppData\Roaming\nvmرا پشتیبانگیری کنید - NVM را حذف کنید
- نسخه جدید NVM را نصب کنید
- محتویات دایرکتوری را از پشتیبان خود بازگردانید
مشکلات Node.js
چرا نمیتوانم یک نسخه خاص Node.js را نصب کنم؟
اگر در نصب یک نسخه خاص مشکل دارید:
- مطمئن شوید که اتصال اینترنت پایدار دارید
- Command Prompt را به عنوان مدیر اجرا کنید
- موقتاً آنتیویروس یا فایروال خود را غیرفعال کنید
- سعی کنید از یک آینه جایگزین استفاده کنید:bash
nvm node_mirror https://npmmirror.com/mirrors/node/
چگونه از یک نسخه خاص Node.js برای یک پروژه استفاده کنم؟
دو روش برای مشخص کردن نسخه Node.js برای یک پروژه وجود دارد:
- یک فایل
.nvmrcدر ریشه پروژه با شماره نسخه ایجاد کنید (مثلاً18.16.0) - به صورت دستی به نسخه مورد نیاز هنگام کار روی پروژه تغییر دهید:bash
nvm use 18.16.0
چرا هنگام نصب بستههای سراسری خطاهای مجوز دریافت میکنم؟
اگر هنگام نصب بستههای سراسری npm خطاهای مجوز دریافت میکنید:
- مطمئن شوید که Command Prompt را با دسترسی مدیر اجرا میکنید
- بررسی کنید که از نسخه صحیح Node.js استفاده میکنید:bash
nvm current
مشکلات پیکربندی
چگونه یک نسخه پیشفرض Node.js را پیکربندی کنم؟
برای پیکربندی یک نسخه پیشفرض که هر بار که یک پنجره ترمینال جدید باز میکنید استفاده شود:
bash
nvm alias default 18.16.0چگونه میتوانم سرعت دانلود Node.js را افزایش دهم؟
اگر دانلودها کند هستند، میتوانید NVM را برای استفاده از یک آینه نزدیکتر به مکان خود پیکربندی کنید:
bash
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/برای گزینههای بیشتر به راهنمای آینهها مراجعه کنید.
تنظیمات NVM کجا ذخیره میشوند؟
تنظیمات NVM برای Windows در:
- پیکربندی NVM:
C:\Users\<username>\AppData\Roaming\nvm\settings.txt - نسخههای نصب شده Node.js:
C:\Users\<username>\AppData\Roaming\nvm\<version>
برای nvm-sh (Linux/macOS)، تنظیمات در:
- نصب NVM:
~/.nvm - پیکربندی NVM: متغیرهای محیطی در فایل پروفایل shell شما
مشکلات خاص Windows
آیا NVM در PowerShell کار میکند؟
بله، NVM برای Windows در Command Prompt (cmd) و PowerShell کار میکند. با این حال، اگر با PowerShell مشکل دارید، مطمئن شوید که اجرای اسکریپت فعال است:
powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserچگونه NVM را با Visual Studio Code استفاده کنم؟
برای استفاده از NVM با Visual Studio Code:
- یک نسخه پیشفرض Node.js با استفاده از
nvm alias default <version>تنظیم کنید - VS Code را راهاندازی مجدد کنید تا نسخه Node.js را تشخیص دهد
- یا میتوانید مسیر کامل به نسخه Node.js را در تنظیمات VS Code مشخص کنید
چگونه NVM را با WSL (Windows Subsystem for Linux) استفاده کنم؟
NVM برای Windows مستقیماً در WSL کار نمیکند، زیرا WSL از یک محیط Linux استفاده میکند. برای WSL، باید نسخه Linux NVM (nvm-sh/nvm) را نصب کنید. برای دستورالعملها به راهنمای نصب nvm-sh مراجعه کنید.
مشکلات خاص Linux/macOS
چرا NVM پس از نصب روی Linux/macOS کار نمیکند؟
اگر NVM پس از نصب کار نمیکند:
- مطمئن شوید که فایل پروفایل خود را source کردهاید:bash
source ~/.bashrc # یا ~/.zshrc، ~/.profile و غیره - بررسی کنید که کد اولیهسازی NVM به فایل پروفایل شما اضافه شده است
- ترمینال خود را راهاندازی مجدد کنید یا یک ترمینال جدید باز کنید
چگونه NVM را با یک shell خاص استفاده کنم؟
NVM با bash، zsh و سایر shellها کار میکند. مطمئن شوید که کد اولیهسازی NVM به فایل پروفایل صحیح برای shell شما اضافه شده است:
- Bash:
~/.bashrcیا~/.bash_profile - Zsh:
~/.zshrc - Ksh:
~/.profile
عیبیابی پیشرفته
چگونه مشکلات NVM را دیباگ کنم؟
برای دریافت اطلاعات بیشتر درباره آنچه NVM انجام میدهد، میتوانید لاگگیری را فعال کنید:
- یک فایل
settings.txtدر دایرکتوری نصب NVM خود ایجاد یا ویرایش کنید - خط را اضافه کنید:
root: <مسیر نصب NVM> - خط را اضافه کنید:
log: <مسیری که میخواهید لاگها را ذخیره کنید>
چگونه مشارکت کنم یا باگ را گزارش دهم؟
اگر باگی پیدا کردید یا میخواهید به پروژه کمک کنید:
- مشکلات را در مخزن GitHub nvm-windows یا مخزن GitHub nvm-sh گزارش دهید
- مطمئن شوید که جزئیات درباره سیستم عامل، نسخه NVM و مراحل بازتولید مشکل را شامل میشود
سوالات عمومی
تفاوت بین NVM برای Windows و nvm-sh چیست؟
NVM برای Windows (nvm-windows) یک پیادهسازی مجدد از NVM به طور خاص برای Windows است، در حالی که nvm-sh/nvm پیادهسازی اصلی برای سیستمهای Unix/Linux است. در حالی که هدف مشابهی دارند، کدبیسهای متفاوتی دارند و برخی تفاوتها در دستورات و ویژگیها دارند.
آیا میتوانم NVM برای Windows را روی سیستمهای عامل 32 بیتی استفاده کنم؟
بله، NVM برای Windows با سیستمهای عامل Windows 32 بیتی و 64 بیتی سازگار است. میتوانید با استفاده از دستور nvm arch بین معماریها جابجا شوید.
آیا NVM به طور خودکار npm را نصب میکند؟
بله، هنگامی که یک نسخه Node.js را با استفاده از NVM نصب میکنید، npm به طور خودکار به عنوان بخشی از بسته Node.js نصب میشود.