كيفية إعداد Windows لتطوير Node.js باستخدام NVM

لماذا تحتاج إلى إعداد Windows لتطوير Node.js بطريقة صحيحة؟

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

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

تثبيت Windows Terminal على Windows

إذا كنت تستخدم Windows 11، فغالباً ستجد أن Windows Terminal مثبت مسبقاً. أما إذا كنت تستخدم إصداراً أقدم، فيمكنك تنزيله مجاناً من Microsoft Store.

يُعد Windows Terminal طرفية حديثة تدعم التبويبات وتسمح لك بتشغيل واجهات مثل:

• PowerShell
• CMD
• WSL

واستخدامه يمنحك تجربة تطوير أكثر تنظيماً وقرباً من البيئات الموجودة على الأنظمة الأخرى. لذلك، إذا كنت تنوي تطوير مشاريع Node.js على Windows، فإن تثبيته خطوة موصى بها بشدة.

كيفية تثبيت NVM for Windows

بدلاً من تثبيت Node.js مباشرة من الموقع الرسمي، من الأفضل تثبيت Node Version Manager أو NVM for Windows. هذه الأداة تتيح لك تنزيل أكثر من إصدار من Node.js والتبديل بينها بسهولة حسب متطلبات كل مشروع.

إذا كان Node.js مثبتاً مسبقاً على جهازك، فمن المحتمل أن يتمكن NVM من استبدال المتغيرات والروابط المتعلقة به. ومع ذلك، يُستحسن إزالة التثبيت القديم لتفادي أي تعارضات أو بقايا إعدادات قد تسبب مشاكل لاحقاً.

انتقل إلى صفحة مشروع NVM for Windows ثم نزّل أحدث إصدار متاح من ملف nvm-setup.zip من صفحة releases. انتبه إلى أن هذا المشروع ليس هو نفسه NVM المخصص لأنظمة UNIX، لكنه يؤدي وظيفة مشابهة بدرجة كبيرة.

بعد فك الضغط عن الملفات، شغّل الملف nvm-setup.exe. ستظهر لك خطوات التثبيت المعتادة، مثل الموافقة على الترخيص واختيار مسار التثبيت.

عادةً يكون حفظ ملفات NVM داخل مجلد AppData\Roaming الخاص بالمستخدم خياراً مناسباً. لكن النقطة الأهم تظهر عند تحديد مكان Node.js symlink.

تنبيه مهم حول مسار التثبيت

يجب ألا يحتوي مسار symlink على فراغات whitespaces. وهذه مشكلة شائعة لأن المسار الافتراضي مثل C:\Program Files\nodejs يحتوي على فراغ، ما قد يؤدي إلى أخطاء أثناء عمل NVM.

لذلك، يُفضل اختيار مسار بسيط مثل:

C:\nodejs

أو أي مسار آخر لا يحتوي على فراغات. بهذه الطريقة تقل احتمالات حدوث مشاكل مستقبلية، كما يصبح تتبع ملفات التثبيت وإدارتها أكثر سهولة.

كيفية تثبيت Node.js وإعداد NVM

بعد تثبيت NVM، شغّل Windows Terminal بصلاحيات المسؤول Run as Administrator. هذه الخطوة مهمة لأن بعض أوامر NVM، خصوصاً المتعلقة بالتبديل بين الإصدارات، تحتاج إلى صلاحيات إدارية.

إذا أردت الاطلاع على الأوامر المتاحة داخل NVM، فما عليك إلا كتابة الأمر التالي:

nvm

لبدء العمل، تأكد أولاً من تفعيل NVM عبر الأمر التالي:

nvm on

بعد ذلك، يمكنك تثبيت إصدار LTS من Node.js باستخدام:

nvm install lts

عند اكتمال التثبيت، اختر الإصدار الذي تريد استخدامه فعلياً بالأمر التالي:

nvm use 14.18.1

بعد تنفيذ هذا الأمر، تصبح أوامر مثل node وnpm مرتبطة بهذا الإصدار المحدد.

تثبيت Yarn بشكل عام

بعد تجهيز Node.js، يمكنك تثبيت مدير الحزم yarn باستخدام npm:

npm install -g yarn

ثم تحقق من نجاح العملية عبر:

yarn -v

إذا ظهرت لك نسخة yarn، فهذا يعني أن الإعداد تم بنجاح وأن البيئة جاهزة للعمل.

إدارة عدة إصدارات من Node.js باستخدام NVM

القيمة الحقيقية من NVM تظهر عندما تحتاج إلى تشغيل مشاريع تعتمد على إصدارات مختلفة من Node.js. لذلك، من المفيد تثبيت إصدار أحدث إلى جانب إصدار LTS.

لتثبيت أحدث إصدار متاح، استخدم:

nvm install latest

ولمعرفة الإصدارات المثبتة محلياً على جهازك، استخدم:

nvm list

أما للتبديل إلى إصدار آخر، فالأمر بسيط جداً:

nvm use 16.11.1

من المهم أن تعرف أن كل إصدار من Node.js يحتفظ ببيئته الخاصة، بما في ذلك الحزم المثبتة بشكل عام global packages. هذا يعني أنه إذا ثبتَّ yarn على إصدار معين، فلن يكون متاحاً تلقائياً على الإصدارات الأخرى إلا إذا قمت بتثبيته لكل إصدار على حدة.

فوائد استخدام NVM في مشاريع Node.js

• تشغيل مشاريع قديمة وحديثة على الجهاز نفسه.
• تجنب تعارض الإصدارات بين المشاريع المختلفة.
• اختبار التوافق بسرعة بين أكثر من نسخة من Node.js.
• الحفاظ على بيئة تطوير منظمة ومرنة.

حلول لأشهر مشاكل NVM وNode.js على Windows

بطء شديد في تنزيل الحزم عبر npm أو yarn

إذا لاحظت أن التنزيلات بطيئة بشكل غير طبيعي، فتحقق أولاً من أن الشبكة مُصنّفة داخل Windows على أنها Private وليست Public. أحياناً يتعامل جدار الحماية مع الشبكات العامة بشكل متشدد، ما يؤثر في أداء التنزيلات.

إذا استمرت المشكلة، أضف مجلد NVM إلى قائمة الاستثناءات في برنامج مكافحة الفيروسات. وغالباً يكون المسار الافتراضي كالتالي:

C:\Users\<your_user_name>\AppData\Roaming\nvm

بطء تنفيذ الأوامر داخل Node.js

يعتمد Windows على نظام الملفات NTFS، وهو ليس الأفضل عند التعامل مع عدد ضخم من الملفات الصغيرة. وبما أن مشاريع Node.js تشتهر بكثرة الحزم والاعتماديات داخل node_modules، فقد تلاحظ بطئاً في عمليات مثل بناء المشاريع أو تحويل ملفات TypeScript.

لتخفيف هذه المشكلة، يمكنك تجربة أحد الحلول التالية:

1. استخدام قرص SSD إذا كان جهازك ما يزال يعمل على تخزين أبطأ.
2. تقليل العمليات غير الضرورية التي تفحص الملفات في الخلفية.
3. الاعتماد على WSL إذا كانت سرعة التنفيذ على Windows غير عملية بالنسبة لمشاريعك.

ظهور الخطأ 145 عند تنفيذ بعض أوامر NVM

هذا الخطأ يرتبط غالباً بمسار التثبيت، وبالتحديد عندما يتم تثبيت NVM أو إعداد symlink داخل مسار يحتوي على فراغات. إذا واجهت هذا الخطأ، فأفضل حل هو:

1. إزالة تثبيت NVM.
2. إعادة تشغيل الملف nvm-setup.exe.
3. اختيار مسارات خالية تماماً من الفراغات.

هذه الخطوة وحدها تحل نسبة كبيرة من مشاكل التثبيت الشائعة على Windows.

أفضل ممارسات العمل بعد إعداد Node.js على Windows

بعد نجاح التثبيت والتبديل بين الإصدارات، تصبح بيئة العمل جاهزة تقريباً. لكن للحصول على تجربة تطوير أكثر إنتاجية، يفضل اتباع بعض الممارسات:

• استخدام إصدار LTS للمشاريع الإنتاجية كلما أمكن.
• تثبيت الحزم العامة الضرورية فقط لكل إصدار لتجنب الفوضى.
• الاحتفاظ بقائمة واضحة للإصدارات المستخدمة في مشاريعك.
• تشغيل الطرفية بصلاحيات المسؤول عند الحاجة إلى التبديل بين الإصدارات.

محررات أكواد مقترحة لتطوير JavaScript وTypeScript

إذا كنت تبحث عن محرر مناسب بعد إعداد البيئة، فهذه خيارات عملية:

• Visual Studio Code: خيار متكامل وسهل لمعظم المطورين.
• Sublime Text 3: بديل خفيف وسريع.
• vim: مناسب لمن يفضل بيئة تحرير قوية ويملك الوقت لتعلمها.

الخلاصة التقنية

الاعتماد على NVM for Windows هو الخيار الأكثر مرونة لأي مطور يعمل على أكثر من مشروع Node.js أو يحتاج إلى اختبار توافق الإصدارات. الإعداد الصحيح من البداية، خصوصاً اختيار المسارات الخالية من الفراغات وتشغيل الطرفية بصلاحيات مناسبة، يوفر عليك كثيراً من الأعطال لاحقاً. تقنياً، هذه الطريقة تمنحك بيئة منظمة وقابلة للتوسع، وتُعد من أفضل الممارسات لتطوير JavaScript وTypeScript على Windows.