سوالات متداول nvm-sh (FAQ)

نسخه Linux/macOS

اضافه کردن به ~/.bashrc یا ~/.zshrc:

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

NVM را نصب کرده‌ام، اما دستور nvm کار نمی‌کند

این می‌تواند به دلایل مختلفی ایجاد شود:

1. متغیرهای محیطی به درستی تنظیم نشده‌اند: مطمئن شوید که دایرکتوری NVM به PATH شما اضافه شده است
2. نیاز به راه‌اندازی مجدد ترمینال: پس از نصب، ترمینال یا Command Prompt خود را ببندید و دوباره باز کنید
3. فایل پیکربندی به‌روز نشده است: بررسی کنید که آیا فایل پیکربندی bash شما (.bashrc، .bash_profile، .zshrc و غیره) شامل کد اولیه‌سازی NVM است

مشکلات استفاده

نسخه Node.js هر بار که یک ترمینال جدید باز می‌کنم به پیش‌فرض برمی‌گردد

این اتفاق می‌افتد زیرا NVM نسخه پیش‌فرض را در هر جلسه ترمینال جدید بارگذاری می‌کند. برای حل این مشکل، می‌توانید:

1. یک نسخه پیش‌فرض Node.js تنظیم کنید:

   nvm alias default 14.17.0

2. یک فایل .nvmrc در دایرکتوری پروژه خود ایجاد کنید و nvm use را در دایرکتوری پروژه اجرا کنید

بسته‌های نصب شده سراسری پس از جابجایی نسخه‌های Node.js ناپدید می‌شوند

این رفتار عادی برای NVM است. هر نسخه Node.js مجموعه جداگانه‌ای از بسته‌های سراسری دارد. هنگام جابجایی نسخه‌ها، فقط می‌توانید به بسته‌های سراسری نصب شده برای نسخه فعلی دسترسی داشته باشید.

راه‌حل‌ها شامل:

1. نصب جداگانه بسته‌های سراسری در هر نسخه Node.js که نیاز دارید
2. استفاده از دستور nvm reinstall-packages برای کپی بسته‌ها از یک نسخه به نسخه دیگر

خطاهای SSL هنگام استفاده از nvm install

اگر با مشکلات گواهینامه SSL مواجه شدید، می‌توانید روش‌های زیر را امتحان کنید:

# Windows
nvm install 14.17.0 --insecure

# Linux/macOS
NVM_NODEJS_ORG_MIRROR=http://nodejs.org/dist nvm install 14.17.0

خطا هنگام نصب نسخه Node.js روی macOS

شما با خطای کامپایل ماژول Node.js مواجه هستید، که معمولاً هنگام اجرای npm install یا yarn install رخ می‌دهد. پیام خطای خاص:

# خطا:
/,nym/,cache/src/node-y14.18.0/files/out/Release/obj.target/v8 zlib/deps/v8/third party/zlib/zutil.o] Error 1
make[1]: *** [/Users/.../zutil.o] Error 1

این نشان می‌دهد که کامپایل کتابخانه zlib برای موتور V8 JavaScript که ماژول‌های Node.js به آن وابسته هستند شکست خورده است.

راه‌حل:

# نصب Xcode Command Line Tools
xcode-select --install

# نصب Homebrew (اگر نصب نشده است)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# نصب Python (Python 3 توصیه می‌شود)
brew install python

چگونه NVM را حذف کنیم؟

Linux/macOS

1. حذف دایرکتوری NVM: rm -rf "$NVM_DIR"
2. حذف خطوط مربوط به NVM از فایل‌های پیکربندی shell خود (.bashrc، .bash_profile، .zshrc و غیره)، برای جزئیات به راهنمای نصب مراجعه کنید