Как поставить Node.js и не сломать окружение

Чтобы установить Node.js, в большинстве случаев достаточно выбрать LTS-версию, установить её удобным способом (установщик, пакетный менеджер или nvm) и проверить команды node -v и npm -v в новом окне терминала.

Какую версию Node.js выбрать

Обычно доступны две ветки:

• LTS (Long Term Support) — стабильная, предсказуемая, лучше подходит для учёбы, работы и большинства проектов.
• Current — новее, но обновляется чаще; иногда встречаются несовместимости зависимостей.

Установка Node.js на Windows

Способ 1: официальный установщик

1. Скачайте установщик Node.js (обычно выбирают LTS).
2. Установите с настройками по умолчанию — важно, чтобы Node добавился в PATH.
3. Закройте и заново откройте терминал (PowerShell / Windows Terminal).

Способ 2: через winget

Установка LTS:

winget install -e --id OpenJS.NodeJS.LTS

Установка Current:

winget install -e --id OpenJS.NodeJS

Способ 3: через Chocolatey

choco install nodejs-lts -y

Установка Node.js на macOS

Способ 1: официальный установщик (.pkg)

Скачайте и установите пакет, затем перезапустите терминал.

Способ 2: через Homebrew

brew install node

Если нужна конкретная ветка (например, LTS определённой версии), часто используют формулы вида node@XX:

brew install node@24

Способ 3: через nvm (лучше, если у вас несколько проектов)

nvm позволяет держать несколько версий Node.js и быстро переключаться:

# установка nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# затем перезапустите терминал и установите LTS
nvm install --lts
nvm use --lts

Установка Node.js на Linux

На Linux самый удобный и безопасный для разработки путь — nvm (меньше конфликтов с системными пакетами, проще переключать версии).

Вариант A: nvm (рекомендуется)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# перезапустите терминал
nvm install --lts
nvm use --lts

Вариант B: системный менеджер пакетов

Подходит, если вам нужен Node.js “как системный пакет”, но версия может быть не самой свежей.

Примеры:

• Debian/Ubuntu:

  sudo apt update
  sudo apt install nodejs npm

• Fedora:

  sudo dnf install nodejs

Проверка установки и менеджеры пакетов

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

node -v
npm -v

Если версии выводятся — Node.js и npm установлены.

Если вы используете pnpm или Yarn, удобно включить Corepack (он поставляется с современными версиями Node.js):

corepack enable

Обновление Node.js и типовые ошибки

Как обновлять

• winget:

  winget upgrade --id OpenJS.NodeJS.LTS

• Homebrew:

  brew upgrade node

• nvm (самый гибкий вариант):

  nvm install --lts
  nvm use --lts

Если node / npm не распознаётся

1. Перезапустите терминал.
2. На Windows проверьте, что Node.js попал в PATH.
3. При установке через nvm убедитесь, что строка подключения nvm добавлена в профиль оболочки (~/.bashrc, ~/.zshrc), затем откройте терминал заново.

Ошибки прав при npm i -g ...

На macOS/Linux не лечите это командой sudo npm -g “по привычке”.

Несовместимость версии Node.js с проектом

Если зависимости требуют “node >= …”, проще всего:

• поставить нужную версию через nvm;
• зафиксировать её в .nvmrc (чтобы вся команда использовала одну и ту же версию).