Руководство по команде fnm use

Команда fnm use используется для переключения текущей используемой версии Node.js.

Синтаксис команды

fnm use [OPTIONS] [VERSION]

Параметры

VERSION

Указывает версию Node.js для переключения:

# Переключиться на основную версию
fnm use 20

# Переключиться на конкретную версию
fnm use 20.10.0

# Использовать псевдоним
fnm use default

# Без указания версии, читает из файла версии
fnm use

Опции

--install-if-missing

Автоматически установить версию, если она ещё не установлена:

fnm use 18 --install-if-missing

--silent-if-unchanged

Не выводить сообщение, если версия не изменилась:

fnm use 20 --silent-if-unchanged

--node-dist-mirror

Используется с --install-if-missing для указания зеркала загрузки:

fnm use 18 --install-if-missing --node-dist-mirror=https://npmmirror.com/mirrors/node

--fnm-dir

Указать директорию установки fnm:

fnm use 20 --fnm-dir=/custom/path

--log-level

Установить уровень логирования:

fnm use 20 --log-level=quiet

Примеры использования

Базовое переключение

# Переключиться на Node.js 20
fnm use 20

# Переключиться на Node.js 18.17.0
fnm use 18.17.0

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

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

Переключение с помощью псевдонима

# Использовать предустановленный псевдоним
fnm use default
fnm use legacy

Тихий режим

# Использовать в скриптах для избежания лишнего вывода
fnm use 20 --silent-if-unchanged

Приоритет выбора версии

Когда версия не указана, fnm ищет в следующем порядке:

1. Файл .node-version
2. Файл .nvmrc
3. package.json поле engines.node
4. Версия по умолчанию

Отличие от команды default

• fnm use — Переключает версию для текущей сессии Shell
• fnm default — Устанавливает глобальную версию по умолчанию

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

# Временно переключить версию (только текущий терминал)
fnm use 18

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

Версия не установлена

# Сообщение об ошибке
error: Can't find version 18.0.0

# Решение: Автоматическая установка
fnm use 18 --install-if-missing

Версия node не меняется после переключения

Убедитесь, что конфигурация Shell правильная:

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

# Должен указывать на директорию fnm
# ~/.fnm/node-versions/.../bin/node

Файл версии не работает

# Убедитесь, что --use-on-cd включён
eval "$(fnm env --use-on-cd)"

# Убедитесь, что файл версии существует
cat .node-version

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

• Управление версиями - Руководство по управлению версиями
• Справочник команд - Все подробности о командах
• Команда install - Подробности команды install