تثبيت الحزم عبر npm install قد يفشل بأخطاء محبطة مثل npm ERR! code ERESOLVE. إليك الحلول المرتّبة من الأبسط للأعمق عند العمل مع
Node.js.
الحلّ 1: إعادة بناء نظيفة (الأكثر فعالية)
معظم المشاكل تُحلّ بحذف الحزم وإعادة تثبيتها:
rm -rf node_modules package-lock.json
npm install
على ويندوز استخدم:
rmdir /s /q node_modulesثم احذفpackage-lock.json.
الحلّ 2: تنظيف الكاش التالف
npm cache clean --force
npm install
الحلّ 3: تعارض التبعيات (ERESOLVE)
عند ظهور npm ERR! ERESOLVE unable to resolve dependency tree:
npm install --legacy-peer-deps
هذا يتجاوز تعارض peer dependencies. حلّ مؤقّت — راجع توافق الإصدارات لاحقًا.
الحلّ 4: مشاكل الصلاحيات (EACCES)
عند npm ERR! code EACCES، لا تستخدم sudo كحلّ. الأفضل إصلاح صلاحيات
مجلّد npm أو استخدام مدير إصدارات مثل nvm.
الحلّ 5: تحديث npm نفسه
أحيانًا تكون المشكلة في إصدار npm قديم:
npm install -g npm@latest
node -v && npm -v
جدول التشخيص السريع
| رسالة الخطأ | الحلّ |
|---|---|
ERESOLVE | --legacy-peer-deps أو راجع الإصدارات |
EACCES | أصلح الصلاحيات / استخدم nvm |
| سلوك غريب | احذف node_modules + cache clean |
ENOENT package.json | تأكّد أنك داخل مجلّد المشروع |
الخلاصة
90% من مشاكل npm install تُحلّ بـ حذف node_modules + package-lock وإعادة
التثبيت. ابدأ دائمًا بهذه الخطوة قبل البحث عن حلول معقّدة.