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 версии

LTS (Long Term Support) версии Node.js рекомендуются для производственных сред:

bash
# Установить последнюю LTS версию
fnm install --lts

# Установить конкретную LTS версию
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.xАктивная LTS
Hydrogen18.xОбслуживание
Gallium16.xКонец жизни

Установка конкретной версии

bash
# Установить основную версию (автоматически выбирает последнюю минорную версию)
fnm install 20

# Установить конкретную версию
fnm install 20.10.0

# Установить старую версию
fnm install 14.21.3

Установка с использованием файла версии

Создайте файл .node-version или .nvmrc в директории проекта:

bash
# Создать файл .node-version
echo "20" > .node-version

# fnm автоматически прочитает и установит
fnm install

Использование после установки

Переключение на установленную версию

bash
# Использовать конкретную версию
fnm use 20

# Если версия не установлена, автоматически установить и использовать
fnm use 18 --install-if-missing

Установка версии по умолчанию

bash
# Установить версию по умолчанию
fnm default 20

# Просмотреть текущую версию по умолчанию
fnm default

Использование сразу после установки

bash
# Установить и переключиться на версию немедленно
fnm install 20 --use

Просмотр доступных версий

Просмотр удалённых версий

bash
# Список всех доступных версий
fnm list-remote

# Список только LTS версий
fnm list-remote --lts

# Фильтрация конкретных версий
fnm list-remote --filter=18

# Просмотр последних версий
fnm list-remote --latest

Просмотр локально установленных версий

bash
fnm list

Пример вывода:

* v20.10.0 default
  v18.19.0
  v16.20.2

Использование зеркала для быстрой загрузки

В материковом Китае вы можете использовать зеркало для ускорения загрузок:

bash
# Установить переменную окружения зеркала
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Или указать во время установки
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Общие зеркала:

ЗеркалоURL
npmmirrorhttps://npmmirror.com/mirrors/node
Tsinghua Universityhttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release

Поддержка Corepack

fnm поддерживает Corepack, который может автоматически включать Yarn и pnpm:

bash
# Включить Corepack во время установки
fnm install 20 --corepack-enabled

# Или установить переменную окружения
export FNM_COREPACK_ENABLED=true
fnm install 20

Лучшие практики управления версиями

Управление версиями на уровне проекта

Создайте файл .node-version в корневой директории проекта:

bash
# Указать основную версию
echo "20" > .node-version

# Или указать точную версию
echo "20.10.0" > .node-version

В сочетании с опцией --use-on-cd автоматически переключает версии при входе в директорию:

bash
# Добавить в конфигурацию Shell
eval "$(fnm env --use-on-cd)"

Разработка с несколькими версиями

bash
# Установить несколько версий
fnm install 20
fnm install 18
fnm install 16

# Переключаться между разными проектами
cd project-a && fnm use 20
cd project-b && fnm use 18

Использование псевдонимов

bash
# Установить псевдонимы
fnm alias 20 default
fnm alias 18 legacy

# Переключаться с помощью псевдонимов
fnm use default
fnm use legacy

Общие проблемы

Установка не удалась

Если установка не удалась, проверьте:

  1. Нормально ли сетевое подключение
  2. Нужно ли настроить зеркало
  3. Достаточно ли места на диске
bash
# Повторить с использованием зеркала
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Переключение версии не работает

Убедитесь, что Shell настроен правильно:

bash
# Проверить текущую версию
fnm current

# Проверить путь к node
which node

Очистка старых версий

bash
# Просмотреть установленные версии
fnm list

# Удалить ненужные версии
fnm uninstall 16.20.2

Связанные ссылки