Skip to content

تثبيت Node.js باستخدام fnm

يجعل fnm تثبيت وإدارة إصدارات Node.js بسيطاً وسريعاً. سيوضح هذا الدليل كيفية استخدام fnm لتثبيت Node.js.

البدء السريع

تثبيت أحدث إصدار LTS

bash
fnm install --lts

تثبيت أحدث إصدار

bash
fnm install --latest

تثبيت إصدار محدد

bash
fnm install 20
fnm install 18.17.0

شرح طرق التثبيت

تثبيت إصدار LTS

تُوصى باستخدام إصدارات Node.js LTS (الدعم طويل الأمد) لبيئات الإنتاج:

bash
# Install latest LTS version
fnm install --lts

# Install specific LTS version
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium  # Node.js 16.x

الأسماء الرمزية لإصدارات LTS:

الاسم الرمزيالإصدارالحالة
Iron20.xLTS نشط
Hydrogen18.xصيانة
Gallium16.xنهاية العمر

تثبيت إصدار محدد

bash
# Install major version (automatically selects latest minor version)
fnm install 20

# Install specific version
fnm install 20.10.0

# Install older version
fnm install 14.21.3

التثبيت باستخدام ملف الإصدار

أنشئ ملف .node-version أو .nvmrc في دليل المشروع:

bash
# Create .node-version file
echo "20" > .node-version

# fnm will automatically read and install
fnm install

الاستخدام بعد التثبيت

التبديل إلى الإصدار المثبت

bash
# Use specific version
fnm use 20

# If version is not installed, auto install then use
fnm use 18 --install-if-missing

تعيين الإصدار الافتراضي

bash
# Set default version
fnm default 20

# View current default version
fnm default

الاستخدام فوراً بعد التثبيت

bash
# Install and switch to the version immediately
fnm install 20 --use

عرض الإصدارات المتاحة

عرض الإصدارات البعيدة

bash
# List all available versions
fnm list-remote

# List only LTS versions
fnm list-remote --lts

# Filter specific versions
fnm list-remote --filter=18

# View latest versions
fnm list-remote --latest

عرض الإصدارات المثبتة محلياً

bash
fnm list

مثال المخرجات:

* v20.10.0 default
  v18.19.0
  v16.20.2

استخدام مرآة لتنزيل أسرع

في البر الرئيسي للصين، يمكنك استخدام مرآة لتسريع التنزيلات:

bash
# Set mirror environment variable
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Or specify during installation
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

المرآات الشائعة:

مصدر المرآةURL
npmmirrorhttps://npmmirror.com/mirrors/node
جامعة تسينغهواhttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release

دعم Corepack

يدعم fnم Corepack، والذي يمكنه تمكين Yarn و pnpm تلقائياً:

bash
# Enable Corepack during installation
fnm install 20 --corepack-enabled

# Or set environment variable
export FNM_COREPACK_ENABLED=true
fnm install 20

أفضل ممارسات إدارة الإصدارات

إدارة الإصدارات على مستوى المشروع

أنشئ ملف .node-version في جذر المشروع:

bash
# Specify major version
echo "20" > .node-version

# Or specify exact version
echo "20.10.0" > .node-version

بالاشتراك مع خيار --use-on-cd، يتم تبديل الإصدارات تلقائياً عند دخول الدليل:

bash
# Add to Shell configuration
eval "$(fnm env --use-on-cd)"

التطوير متعدد الإصدارات

bash
# Install multiple versions
fnm install 20
fnm install 18
fnm install 16

# Switch between different projects
cd project-a && fnm use 20
cd project-b && fnm use 18

استخدام الأسماء المستعارة

bash
# Set aliases
fnm alias 20 default
fnm alias 18 legacy

# Switch using aliases
fnm use default
fnm use legacy

المشكلات الشائعة

فشل التثبيت

إذا فشل التثبيت، يرجى التحقق من:

  1. هل اتصال الشبكة طبيعي
  2. هل تحتاج إلى تكوين مرآة
  3. هل هناك مساحة قرص كافية
bash
# Retry using mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

تبديل الإصدار لا يعمل

تأكد من أن الصدفة مهيأة بشكل صحيح:

bash
# Check current version
fnm current

# Check node path
which node

تنظيف الإصدارات القديمة

bash
# View installed versions
fnm list

# Uninstall unneeded versions
fnm uninstall 16.20.2

روابط ذات صلة