Перейти к основному содержимому

Псевдонимы

Псевдоним (alias) — короткое имя, которое вы задаёте для конкретной версии Node.js. Вместо 20.19.1 везде можно писать legacy — и использовать это имя с install, use, uninstall и другими командами версий.

Зарезервированные имена вроде latest и lts встроены в NVM for Windows. Создать псевдоним с такими именами нельзя. Как разрешаются reserved-имена и ваши псевдонимы: Разрешение версий.

Зачем нужны псевдонимы​

  • Стабильная метка для версии, которую команда считает «текущим LTS для приложений» или «legacy CI»
  • Переназначить метку при апгрейде (nvm alias add modern 24.11.0) без переписывания всех скриптов
  • Короткие повседневные команды: nvm use modern вместо полного semver

Создать и использовать псевдоним​

Установите версию (если её ещё нет), затем задайте имя:

nvm install 20.19.1
nvm alias add legacy 20.19.1
"legacy" now refers to v20.19.1

Псевдоним принимается везде, где ожидается version specifier:

nvm use legacy
nvm install legacy
nvm uninstall legacy

Список ваших псевдонимов:

nvm alias list
legacy -> v20.19.1

Обновить существующее имя — снова add (может быть запрос подтверждения; --silent пропускает его):

nvm alias add legacy 22.14.0 --silent

Удалить ненужные имена:

nvm alias remove legacy
nvm alias remove legacy modern
1 alias removed successfully.

Полный справочник команд: nvm alias.

Повседневные примеры​

# Имена версий, между которыми вы переключаетесь чаще всего
nvm alias add apps 22.14.0
nvm alias add tools 24.11.0

nvm use apps
node -v
# v22.14.0

nvm use tools
node -v
# v24.11.0

# В скриптах и документации можно писать «use apps» вместо закреплённого semver
nvm use apps
npm test

Частичные версии при создании псевдонима допустимы — они сохраняются как конкретный релиз:

nvm alias add next 24
nvm alias list next
next -> v24.11.0

(Точный patch зависит от того, какой newest matching 24 был в момент alias add.)

Имена, которые нельзя использовать​

ИмяПочему
default, current, latest, lts, lastВстроенная семантика команд
daily, alpha, beta, prereleaseЗарезервировано на будущее
link, shimИмена режимов работы
lts/* (например lts/iron)Зарезервированное пространство LTS

Берите имена вроде legacy, apps, ci или stable24.

Политика флота (Governance)​

На флотах Governance администраторы могут задать список машинной политики Aliases (запись alias=version на строку). Когда эта политика задана, она владеет картой псевдонимов и блокирует пользовательские псевдонимы из nvm alias.

См. Административные шаблоны, Справочник политики реестра и Governance.