Skip to content

دليل أمر fnm install

يُستخدم أمر fnm install لتثبيت إصدارات Node.js جديدة.

بناء الأمر

bash
fnm install [OPTIONS] [VERSION]

المعاملات

VERSION

تحديد إصدار Node.js المراد تثبيته:

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

# Install specific version
fnm install 20.10.0

# Install LTS version
fnm install lts/iron

# No version specified, reads from version file
fnm install

الخيارات

--lts

تثبيت أحدث إصدار LTS (الدعم طويل الأمد):

bash
fnm install --lts

--latest

تثبيت أحدث إصدار (بما في ذلك غير LTS):

bash
fnm install --latest

--use

التبديل إلى الإصدار فوراً بعد التثبيت:

bash
fnm install 20 --use

--progress

التحكم في عرض شريط تقدم التنزيل:

bash
# Auto display (default)
fnm install 20 --progress=auto

# Always display
fnm install 20 --progress=always

# Never display
fnm install 20 --progress=never

--node-dist-mirror

تحديد مرآة تنزيل Node.js:

bash
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

--arch

تحديد بنية التثبيت:

bash
# Install x64 version
fnm install 20 --arch=x64

# Install ARM64 version
fnm install 20 --arch=arm64

--fnm-dir

تحديد دليل تثبيت fnm:

bash
fnm install 20 --fnm-dir=/custom/path

--log-level

تعيين مستوى السجل:

bash
fnm install 20 --log-level=quiet
fnm install 20 --log-level=error
fnm install 20 --log-level=info

--corepack-enabled

تمكين دعم Corepack:

bash
fnm install 20 --corepack-enabled

أمثلة الاستخدام

تثبيت إصدار LTS

bash
# Install latest LTS
fnm install --lts

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

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

bash
# Install major version
fnm install 20

# Install minor version
fnm install 20.10

# Install exact version
fnm install 20.10.0

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

bash
# Install and switch immediately
fnm install 20 --use

# Install and set as default
fnm install 20 --use && fnm default 20

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

bash
# Use mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

تثبيت بنية محددة

bash
# Install x64 version on Apple Silicon Mac
fnm install 20 --arch=x64

تنسيقات الإصدار

يدعم fnm تنسيقات إصدار متعددة:

التنسيقمثالالوصف
إصدار رئيسي20أحدث 20.x.x
إصدار ثانوي20.10أحدث 20.10.x
إصدار دقيق20.10.0إصدار دقيق
اسم LTSlts/ironالاسم الرمزي لإصدار LTS
أحدث--latestأحدث إصدار

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

الاسم الرمزيالإصدارتاريخ الإصدار
Iron20.x2023-10
Hydrogen18.x2022-10
Gallium16.x2021-10
Erbium14.x2020-10
Dubnium12.x2019-10

متغيرات البيئة

يمكنك تكوين السلوك الافتراضي عبر متغيرات البيئة:

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

# Enable Corepack
export FNM_COREPACK_ENABLED=true

# Set installation directory
export FNM_DIR=~/.fnm

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

فشل التثبيت

bash
# Try using mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

# View detailed logs
fnm install 20 --log-level=info

الإصدار موجود بالفعل

bash
# View installed versions
fnm list

# Use installed version
fnm use 20

التنزيل بطيء

bash
# Configure mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install 20

روابط ذات صلة