Как обновить Node.js без боли

Сначала важное

Обновление Node.js — не всегда одна команда. Если это учебная папка, можно действовать смелее. Если это рабочий проект, сайт клиента, бот или API, сначала нужно понять, какая версия сейчас стоит и на какую версию проект рассчитан

Главная цель урока: обновить Node.js так, чтобы проект не превратился в коробку с неожиданностями

Когда Node.js действительно нужно обновлять

Обновление имеет смысл, если:

• текущая версия уже EOL;
• пакет требует более новую версию Node.js;
• хостинг поддерживает новую LTS, а локально у вас старая;
• в проекте появились ошибки установки зависимостей;
• вы хотите привести учебную среду к актуальной LTS;
• в документации проекта явно указана новая версия.

Не нужно обновляться каждый раз, когда видите новость о новой Current-версии. Для обычной работы держимся LTS

Проверяем текущую версию

В терминале:

node -v
npm -v

Пример:

v18.20.8
10.8.2

Теперь идем на официальный сайт Node.js и смотрим актуальную LTS. На 23 мая 2026 года сайт показывает v24.16.0 LTS. Это не значит, что в тексте через год нужно оставить цифру как вечную истину. В публикации хорошо добавить фразу "проверено на дату публикации" и ссылку на официальный сайт

Проверяем проект перед обновлением

Перед обновлением откройте папку проекта и посмотрите, есть ли файлы:

• .nvmrc;
• .node-version;
• package.json;
• Dockerfile;
• .github/workflows/...;
• документация проекта.

В package.json может быть поле:

{
  "engines": {
    "node": ">=22"
  }
}

Оно подсказывает, какая версия ожидается. Если поле есть, не игнорируйте его

Самый безопасный сценарий

Я бы обновлял так:

1. Зафиксировать текущую версию: node -v.
2. Проверить, запускается ли проект до обновления.
3. Посмотреть, какая LTS актуальна.
4. Обновить Node.js.
5. Открыть новый терминал.
6. Проверить node -v и npm -v.
7. Установить зависимости заново, если нужно.
8. Запустить проект и тесты.

Если проект важный, сначала сделайте отдельную ветку или копию. Обновление окружения иногда вытаскивает старые проблемы зависимостей

Обновление на Windows

Самый понятный способ для новичка:

1. Открыть https://nodejs.org/en/download.
2. Скачать актуальный LTS installer.
3. Запустить установщик.
4. Дойти до конца установки.
5. Закрыть терминал.
6. Открыть терминал заново.
7. Проверить:

node -v
npm -v

Если Windows продолжает показывать старую версию, значит в системе может быть несколько установок Node.js. Проверьте, откуда берется команда:

where node

Если путей несколько, нужно навести порядок в PATH

Обновление на macOS

Если Node.js был установлен официальным .pkg, можно скачать свежий LTS installer и установить поверх

Проверка:

node -v
npm -v
which node

Если Node.js ставился через Homebrew, обычно используют Homebrew. Если через nvm — обновляют через nvm. Важно не смешивать способы без необходимости, иначе потом непонятно, какую версию видит терминал

Обновление на Linux

На Linux все зависит от способа установки. Возможны варианты:

• пакетный менеджер дистрибутива;
• официальный способ со страницы загрузки;
• nvm;
• Docker-образ;
• ручная установка бинарников.

Для учебного компьютера удобен менеджер версий. Для сервера лучше описывать версию явно, чтобы деплой был повторяемым

Проверка:

node -v
npm -v
which node

Если команда показывает старую версию, проверьте, не стоит ли Node.js одновременно через систему и через nvm

А можно обновить Node.js через npm?

Запрос как обновить node js через npm встречается часто, но новичку здесь легко попасть в путаницу. npm — менеджер пакетов JavaScript, а Node.js — среда выполнения. В некоторых инструкциях встречаются глобальные пакеты для управления версиями, но это не самый понятный и надежный стартовый путь

Я бы не начинал обновление Node.js с npm install -g ..., если вы не понимаете, что именно ставите и куда. Проще выбрать официальный установщик или менеджер версий

Что делать с зависимостями после обновления

Если проект перестал запускаться, не спешите переписывать код. Сначала:

npm install

Если ошибки странные, иногда помогает удалить локальные зависимости и поставить заново:

rm -rf node_modules
npm install

На Windows папку node_modules можно удалить через проводник или команду PowerShell. Важнее смысл: зависимости пересобираются под новую среду

Если проект использует нативные модули, после обновления Node.js может потребоваться повторная сборка:

npm rebuild

Типичные ошибки после обновления

Команда показывает старую версию

Откройте новый терминал. Проверьте путь:

where node

на Windows или:

which node

Проект не ставит зависимости

Проверьте текст ошибки. Частые причины:

• пакет слишком старый;
• нужна другая версия Node.js;
• сломался нативный модуль;
• lock-файл зафиксировал старую несовместимую зависимость.

npm стал другой версии

Это нормально: npm обычно идет вместе с Node.js. Не всегда нужно отдельно обновлять npm. Сначала проверьте, работает ли проект

Старый проект требует старый Node.js

Здесь лучше использовать менеджер версий, а не откатывать всю систему. Один проект может жить на старой версии, новый — на LTS

Как проверить, что обновление прошло хорошо

Мини-чеклист:

• node -v показывает ожидаемую версию;
• npm -v работает;
• npm install проходит без критических ошибок;
• проект запускается;
• основные страницы или API отвечают;
• тесты, если они есть, проходят;
• хостинг поддерживает такую же major-версию Node.js.

Если это backend, дополнительно проверьте переменные окружения, подключение к базе и порт

Как писать об этом в публикации

Для SEO-урока важно не обещать "самую новую версию" без даты. Лучше писать:

"На момент проверки, 23 мая 2026 года, официальные страницы Node.js показывают Node.js 24.x как Active LTS. Перед установкой проверьте актуальную версию на nodejs.org."

Так статья выглядит честнее и не стареет через месяц

Ответы на эти вопросы могут быть для вас полезными

Нужно ли удалять старый Node.js перед обновлением?

Не всегда. Официальный установщик часто обновляет версию поверх старой. Но если в системе несколько установок, может понадобиться очистить лишние пути

Почему после обновления проект сломался?

Возможно, зависимости не поддерживают новую major-версию Node.js или проект был привязан к старой версии. Проверьте package.json, .nvmrc и текст ошибки

Можно ли держать несколько версий Node.js?

Да. Для этого используют менеджеры версий. Это удобно, если у вас несколько проектов с разными требованиями

Нужно ли обновлять npm отдельно?

Обычно сначала нет. Проверьте npm после обновления Node.js и запускайте проект. Отдельно обновлять npm стоит только при понятной необходимости

Что выбрать после обновления: LTS или Current?

Для обычной работы и учебы — LTS. Current выбирайте только если вам действительно нужны свежие возможности

Что почитать дальше по Node.js

Если вы собираете тему по шагам, рядом лучше открыть:

• Node.js LTS: какую версию ставить новичку — сначала выбрать целевую версию, а потом обновляться.
• Как установить Node.js и npm — вернуться к базовой установке, если среда сломалась.
• Первый сервер на Express — проверить обновление на простом сервере.
• Хостинг для Node.js сайта: что проверять перед выбором — согласовать локальную и серверную версии Node.js.