Справочник команд fnm

fnm предоставляет лаконичный и мощный набор инструментов командной строки для управления версиями Node.js.

Обзор команд

fnm [OPTIONS] <COMMAND>

Глобальные опции

Опция	Описание	По умолчанию
--node-dist-mirror <URL>	Зеркало загрузки Node.js	https://nodejs.org/dist
--fnm-dir <DIR>	Директория установки fnm	~/.fnm
--log-level <LEVEL>	Уровень логирования	info
--arch <ARCH>	Переопределение архитектуры	Архитектура системы
--version-file-strategy <STRATEGY>	Стратегия парсинга файлов версий	local
--corepack-enabled	Включить Corepack	false
--resolve-engines	Разрешать engines.node в package.json	true

Основные команды

fnm install

Установка новых версий Node.js.

fnm install [OPTIONS] [VERSION]

Параметры:

• VERSION - Номер версии, может быть частичным semver или именем LTS версии (например, lts/iron)

Опции:

• --lts - Установить последнюю LTS версию
• --latest - Установить последнюю версию
• --use - Использовать версию сразу после установки
• --progress <auto|never|always> - Отображать прогресс-бар загрузки

Примеры:

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

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

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

# Установить конкретную LTS версию
fnm install lts/iron

# Установить и использовать немедленно
fnm install 20 --use

fnm use

Переключение версии Node.js.

fnm use [OPTIONS] [VERSION]

Опции:

• --install-if-missing - Автоматически установить, если версия не установлена
• --silent-if-unchanged - Не выводить сообщение, если версия не изменилась

Примеры:

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

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

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

fnm list

Список локально установленных версий Node.js.

fnm list [OPTIONS]

Псевдоним: ls

Пример:

fnm list

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

* v20.10.0 default
  v18.19.0
  v16.20.2

fnm list-remote

Список всех доступных удалённых версий Node.js.

fnm list-remote [OPTIONS]

Псевдоним: ls-remote

Опции:

• --filter <FILTER> - Фильтрация по номеру версии или диапазону semver
• --lts [<NAME>] - Показывать только LTS версии
• --latest - Показывать только последние версии
• --sort <asc|desc> - Порядок сортировки

Примеры:

# Список всех версий
fnm list-remote

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

# Список конкретной LTS версии
fnm list-remote --lts=iron

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

# Показать только последние версии
fnm list-remote --latest

fnm uninstall

Удаление версии Node.js.

fnm uninstall [OPTIONS] [VERSION]

Псевдоним: uni

Примеры:

# Удалить конкретную версию
fnm uninstall 16.20.2

# Удалить через псевдоним
fnm uninstall default

WARNING

Если предоставлен псевдоним, fnm удалит версию Node.js, на которую указывает псевдоним, а также другие псевдонимы, указывающие на ту же версию.

Команды управления версиями

fnm default

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

fnm default [VERSION]

Примеры:

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

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

fnm current

Отображение текущей используемой версии Node.js.

fnm current

Пример:

fnm current
# Вывод: v20.10.0

fnm alias

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

fnm alias <VERSION> <NAME>

Примеры:

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

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

fnm unalias

Удаление псевдонима.

fnm unalias <NAME>

Пример:

fnm unalias legacy

Команды конфигурации окружения

fnm env

Вывод конфигурации переменных окружения Shell.

fnm env [OPTIONS]

Опции:

• --shell <bash|zsh|fish|powershell> - Указать тип Shell
• --json - Вывод в формате JSON
• --use-on-cd - Вывод скрипта автоматического переключения версий

Примеры:

# Вывод текущей конфигурации Shell
fnm env

# Вывод конфигурации Bash
fnm env --shell bash

# Вывод в формате JSON
fnm env --json

# Включить автоматическое переключение версий
fnm env --use-on-cd

fnm completions

Вывод скрипта завершения Shell.

fnm completions [OPTIONS]

Опции:

• --shell <bash|zsh|fish|powershell> - Указать тип Shell

Примеры:

# Bash
fnm completions --shell bash >> ~/.bashrc

# Zsh
fnm completions --shell zsh >> ~/.zshrc

# Fish
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# PowerShell
fnm completions --shell powershell >> $PROFILE

Расширенные команды

fnm exec

Выполнение команды в среде указанной версии Node.js.

fnm exec [OPTIONS] -- <COMMAND>

Опции:

• --using <VERSION> - Указать версию для использования

Примеры:

# Выполнить команду используя Node.js 18
fnm exec --using=18 -- node --version

# Запустить скрипт используя конкретную версию
fnm exec --using=20 -- npm run build

Шпаргалка по командам

Команда	Псевдоним	Описание
install	i	Установить версию Node.js
use	-	Переключить версию Node.js
list	ls	Список установленных версий
list-remote	ls-remote	Список удалённых версий
uninstall	uni	Удалить версию Node.js
default	-	Установить/получить версию по умолчанию
current	-	Показать текущую версию
alias	-	Установить псевдоним версии
unalias	-	Удалить псевдоним
env	-	Вывод конфигурации окружения
completions	-	Вывод скрипта завершения
exec	-	Выполнить команду в указанной версии

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

• Установка Node.js - Подробное руководство по установке
• Управление версиями - Лучшие практики управления версиями
• Команда install - Подробное объяснение команды install