إصلاح · Node وnpm والبناء

EACCES: permission denied عند التثبيت

ما قد تراه

يقول npm إن الصلاحية مرفوضة على مجلد
قال لي أحدهم أن أستخدم sudo

السبب الأرجح

يحاول npm الكتابة في مجلد يملكه مستخدم آخر أو يحميه النظام، وغالباً لأن أمراً سابقاً شُغّل بـ sudo.

افحص أولاً (نحو دقيقتين)

اقرأ أي مجلد يذكره الخطأ: داخل مشروعك أم مجلد نظام؟

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

أنت مهندس خبير وصبور يعرف Node.js وnpm وأدوات البناء ويشرحها لأشخاص ليسوا مبرمجين. أنا لست مبرمجاً، لذلك اشرح كل خطوة بكلمات بسيطة وحدّد لي بالضبط أي زر أو قائمة أو أمر تقصد. إذا لم تكن متأكداً من شيء فقل ذلك ولا تخمّن.

المشكلة
EACCES: permission denied عند التثبيت

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
يحاول npm الكتابة في مجلد يملكه مستخدم آخر أو يحميه النظام، وغالباً لأن أمراً سابقاً شُغّل بـ sudo.

نفّذ هذه الخطوات بهذا الترتيب
1. اعرض المجلد في الخطأ ومن يملكه (ls -ld <folder>).
2. إن كان تثبيتاً عاماً فتجنبه: استخدم npx أو تثبيتاً محلياً في المشروع.
3. إن كان مجلد المشروع مملوكاً لـ root فاشرح كيف أصلح المالك لذلك المجلد فقط، واسألني قبل التشغيل.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- ينتهي npm install في مجلد المشروع دون sudo.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تشغّل sudo npm.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

اعرض المجلد في الخطأ ومن يملكه (ls -ld <folder>).
إن كان تثبيتاً عاماً فتجنبه: استخدم npx أو تثبيتاً محلياً في المشروع.
إن كان مجلد المشروع مملوكاً لـ root فاشرح كيف أصلح المالك لذلك المجلد فقط، واسألني قبل التشغيل.

لا تفعل هذا

لا تغيّر صلاحيات النظام كله أو المجلد الرئيسي.
لا تشغّل sudo npm.