يعد Node Version Manager (NVM) أداة لا غنى عنها لمطوري Node.js الذين يقومون بشكل متكرر بالتبديل بين إصدارات مختلفة من Node.js لمختلف المشاريع. سواء كنت تحتفظ بالتطبيقات القديمة، أو تجرب أحدث الميزات، أو تحتاج ببساطة إلى إصدار مختلف لمشاريع مختلفة، يمكن لـ NVM أن يجعل حياتك أسهل بكثير. في هذه المدونة، سنتعمق في NVM، ونستكشف التقنيات المتقدمة وأفضل الممارسات لإدارة إصدارات Node.js بكفاءة.

لماذا نستخدم NVM؟

قبل أن ننتقل إلى الاستخدام المتقدم لـ NVM، دعنا نلخص بسرعة سبب استخدامه:

1. إدارة الإصدار: التبديل بسهولة بين إصدارات Node.js المتعددة.
2. عزل البيئة: تأكد من أن كل مشروع يستخدم إصدار Node.js المطلوب دون تعارضات.
3. الملاءمة: تبسيط عملية تثبيت وتحديث إصدارات Node.js.

تثبيت NVM

للأنظمة المستندة إلى Unix (Linux/macOS)

للبدء في استخدام NVM على الأنظمة المستندة إلى Unix، تحتاج إلى تثبيته. عملية التثبيت واضحة ومباشرة:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash

بعد تشغيل البرنامج النصي، أضف الأسطر التالية إلى ملف .bashrc أو .zshrc أو .profile:

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

أعد تحميل تكوين الصدفة الخاص بك:

source ~/.bashrc  # or ~/.zshrc, ~/.profile depending on your shell

للنوافذ

بالنسبة لنظام التشغيل Windows، يمكنك استخدام nvm-windows، وهي أداة مماثلة مصممة لبيئات Windows.

1. قم بتنزيل برنامج التثبيت من مستودع nvm-windows.
2. قم بتشغيل برنامج التثبيت واتبع التعليمات التي تظهر على الشاشة.

بعد التثبيت، افتح موجه أوامر جديد وتحقق من التثبيت:

nvm version

الاستخدام الأساسي

مع تثبيت NVM، دعونا نغطي بعض الأوامر الأساسية:

تثبيت إصدارات Node.js

يمكنك تثبيت أي إصدار من Node.js عن طريق تحديده:

nvm install 14.20.1  # Install Node.js 14.20.1
nvm install 18.0.0   # Install Node.js 18.0.0

سرد الإصدارات المثبتة

لرؤية جميع إصدارات Node.js المثبتة:

nvm ls

استخدام إصدار محدد

التبديل إلى إصدار محدد لجلستك الحالية:

nvm use 14.20.1

تحديد الإصدار الافتراضي

قم بتعيين إصدار Node.js الافتراضي لاستخدامه في جميع الأصداف الجديدة:

nvm alias default 14.20.1

استخدام NVM المتقدم

الآن بعد أن أصبحت على دراية بالأساسيات، دعنا نستكشف تقنيات NVM المتقدمة.

العمل مع ملفات nvmrc

يمكن لملف .nvmrc تحديد إصدار Node.js للمشروع. قم بإنشاء ملف .nvmrc في الدليل الجذر لمشروعك الذي يحتوي على إصدار Node.js المطلوب:

14.20.1

عند الانتقال إلى دليل المشروع، استخدم الأمر التالي للتبديل إلى الإصدار المحدد:

nvm use

يمكنك أتمتة هذه العملية باستخدام وظيفة Shell التي تقوم بتحميل الإصدار تلقائيًا عند إدخال القرص المضغوط في الدليل:

# Add this to your .bashrc or .zshrc
autoload -U add-zsh-hook
load-nvmrc() {
  if [[ -f .nvmrc ]]; then
    nvm use
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

تثبيت متغيرات Node.js محددة

يسمح لك NVM بتثبيت إصدارات مختلفة من Node.js، مثل io.js أو إصدارات LTS المختلفة:

nvm install iojs
nvm install --lts

التحقق من وجود إصدارات جديدة

حافظ على تحديث إصدارات Node.js باستخدام:

nvm ls-remote

يسرد هذا الأمر جميع إصدارات Node.js المتاحة، مما يسمح لك بمعرفة ما إذا كان قد تم إصدار إصدار جديد.

إلغاء تثبيت إصدارات Node.js

إزالة إصدارات Node.js غير المستخدمة لتحرير المساحة:

nvm uninstall 14.20.1

أتمتة البرنامج النصي

بالنسبة للأتمتة وخطوط أنابيب CI/CD، يمكنك استخدام NVM ضمن البرامج النصية. فيما يلي مثال لكيفية استخدام NVM في برنامج نصي bash:

#!/bin/bash

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

nvm install 14.20.1
nvm use 14.20.1

node -v

إدارة الحزم العالمية

يتم تثبيت الحزم العامة لكل إصدار Node.js. لإدارة ذلك بكفاءة، استخدم أمر إعادة تثبيت حزم nvm:

nvm install 18.0.0
nvm reinstall-packages 14.20.1

يعيد هذا الأمر تثبيت كافة الحزم العامة من الإصدار 14.20.1 إلى 18.0.0.

باستخدام مع عامل الميناء

بالنسبة للمشاريع التي تستخدم Docker، يمكنك تبسيط ملفات Dockerfiles الخاصة بك باستخدام NVM لتثبيت Node.js:

FROM ubuntu:20.04

# Install dependencies
RUN apt-get update && apt-get install -y curl

# Install NVM
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash

# Set up NVM environment
ENV NVM_DIR /root/.nvm
ENV NODE_VERSION 14.20.1
RUN . $NVM_DIR/nvm.sh && nvm install $NODE_VERSION

# Ensure Node.js is available
ENV PATH $NVM_DIR/versions/node/v$NODE_VERSION/bin:$PATH

# Verify installation
RUN node -v

استكشاف الأخطاء وإصلاحها والنصائح

مشاكل شائعة

1. لم يتم العثور على أمر NVM: تأكد من أن ملفات تكوين Shell الخاصة بك مصدر NVM بشكل صحيح.
2. مشكلات الأذونات: قم بتشغيل الأوامر بالأذونات المناسبة أو اضبط مسار تثبيت NVM الخاص بك.

أفضل الممارسات

1. تحديث NVM بانتظام: حافظ على تحديث NVM نفسه للاستفادة من الميزات الجديدة وإصلاحات الأخطاء.
2. استخدام ملفات nvmrc.: يضمن ذلك الاتساق عبر بيئات التطوير ومسارات CI.
3. إدارة الحزم العالمية: قم بمزامنة الحزم العالمية بانتظام عبر إصدارات Node.js للحفاظ على الاتساق.

خاتمة

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

تعليمات سعيدة!