Как установить Node.js и npm на Windows, macOS и Linux

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

Перед тем как установить Node.js, определитесь с веткой. На nodejs.org всегда две кнопки: LTS (Long Term Support, долгая поддержка) и Current (самая свежая). Для работы, учёбы, сборки фронтенда, Vite, React и Laravel Mix берите LTS: в ней исправляют ошибки и уязвимости около трёх лет, а пакеты из npm гарантированно с ней дружат. Current нужна, только если вы хотите попробовать новую возможность языка раньше всех.

Чётные версии (20, 22, 24, 26) становятся LTS примерно через полгода после выхода. Состояние веток на ноябрь 2026 года:

Если проект требует конкретную версию (поле engines в package.json или файл .nvmrc), ставьте Node.js через nvm: тогда на одном компьютере уживутся 22, 24 и 26, а переключение займёт секунду.

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

На Windows есть три удобных способа: установщик MSI с официального сайта, команда winget и nvm-windows. Если вам нужна одна версия и вы не хотите разбираться с менеджерами, выбирайте установщик.

Через установщик с nodejs.org

1. Откройте nodejs.org и перейдите в раздел "Download".
2. Выберите LTS-версию, систему Windows и архитектуру x64 (для ноутбуков на Snapdragon выберите ARM64), скачайте файл .msi.
3. Запустите установщик и нажимайте "Next", путь оставьте по умолчанию: C:\Program Files\nodejs\.
4. На экране "Custom Setup" проверьте, что включены пункты "npm package manager" и "Add to PATH".
5. Галочку "Automatically install the necessary tools" можно не ставить: она нужна только для сборки нативных модулей (компилятор C++ и Python). Если позже какой-то пакет потребует их, установщик можно запустить повторно.
6. Нажмите "Install", подтвердите запрос контроля учётных записей и дождитесь окончания.
7. Закройте все открытые окна терминала и VS Code, откройте новое окно и проверьте установку.

Через winget в PowerShell

В Windows 10 (версии 1809 и новее) и Windows 11 уже есть менеджер пакетов winget. Одна команда скачает и поставит LTS-версию, а потом так же её обновит:

# Установить текущую LTS-версию Node.js
winget install OpenJS.NodeJS.LTS

# Обновить позже
winget upgrade OpenJS.NodeJS.LTS

Так удобно ставить Node.js через PowerShell или через терминал на новой машине по списку команд. После установки тоже откройте новое окно терминала: старое не видит обновлённую переменную PATH.

Если команда node не находится

Сообщение ""node" не является внутренней или внешней командой" почти всегда значит, что окно терминала было открыто до установки. Откройте новое. Если не помогло, проверьте PATH: нажмите Win + R, введите sysdm.cpl, откройте "Дополнительно → Переменные среды" и убедитесь, что в переменной Path есть строки C:\Program Files\nodejs\ и %APPDATA%\npm (во второй папке лежат глобальные пакеты). Похожим образом устроен PATH у Composer, подробно о нём в разделе про удаление и переустановку Composer в Windows.

Если PowerShell пишет "Невозможно загрузить файл npm.ps1, так как выполнение сценариев отключено в этой системе", запускайте команды в "Командной строке" (cmd) или в Git Bash, где этого ограничения нет, либо вызывайте npm.cmd вместо npm. Менять политику выполнения сценариев можно только для своего пользователя и только если вы понимаете последствия.

Установка Node.js на Ubuntu и другие Linux

Команда sudo apt install nodejs на Ubuntu работает, но ставит версию из репозитория дистрибутива: она часто отстаёт на одну-две LTS, а npm в ней идёт отдельным пакетом. Для разработки лучше один из двух вариантов ниже.

Репозиторий NodeSource

Компания NodeSource собирает пакеты Node.js для Ubuntu и Debian. Подключаете их репозиторий нужной ветки и ставите пакет через apt как обычно, обновления потом приходят вместе с apt upgrade. Это хороший вариант для сервера, где Node.js нужен всем пользователям системы:

# Подключить репозиторий ветки 26.x (номер замените на нужную LTS)
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
sudo bash nodesource_setup.sh

# Установить Node.js вместе с npm
sudo apt install -y nodejs

# Проверить
node -v
npm -v

Скрипт настройки лучше скачать и только потом запустить, как в примере: так можно открыть его в редакторе и посмотреть, что он делает. На Fedora, Rocky Linux и AlmaLinux вместо setup_26.x из deb.nodesource.com используется rpm.nodesource.com, а пакет ставится через dnf install nodejs.

Для разработки на своей машине

На рабочем компьютере с Linux удобнее nvm (о нём ниже): он ставит Node.js в домашнюю папку, не требует sudo и избавляет от ошибки EACCES при npm install -g. Если вы раньше поставили nodejs через apt и хотите перейти на nvm, сначала удалите пакет командой sudo apt remove nodejs npm, чтобы две версии не путались в PATH.

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

На Mac есть установщик .pkg с nodejs.org: скачайте его для своей архитектуры (Apple Silicon или Intel обычно определяется автоматически), запустите и пройдите шаги. Если у вас уже стоит Homebrew, проще одной командой:

# Последняя версия Node.js
brew install node

# Или конкретная LTS-ветка
brew install node@24
brew link --overwrite node@24

Учтите, что формула node в Homebrew обновляется до самой свежей версии, включая Current. Если нужна именно LTS и стабильность, используйте формулу с номером ветки или nvm.

Установка через nvm: несколько версий на одном компьютере

nvm (Node Version Manager) скачивает любые версии Node.js и переключает их командой. Для macOS и Linux это проект nvm-sh/nvm, для Windows отдельная программа nvm-windows с похожими командами.

nvm на Linux и macOS

# Установить nvm (номер версии сверьте с README проекта на GitHub)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# Перечитать настройки оболочки, чтобы команда nvm появилась
source ~/.bashrc      # для zsh: source ~/.zshrc

# Поставить текущую LTS и сделать её версией по умолчанию
nvm install --lts
nvm alias default lts/*

# Поставить ещё одну ветку и переключиться на неё
nvm install 24
nvm use 24

# Посмотреть установленные версии
nvm ls

Актуальную строку установки берите из README на github.com/nvm-sh/nvm: номер в адресе скрипта меняется с выходом новых версий nvm.

nvm-windows

Перед установкой nvm-windows удалите Node.js, поставленный через MSI ("Параметры → Приложения → Установленные приложения → Node.js → Удалить"), иначе две копии будут конфликтовать. Затем:

# Установить nvm-windows
winget install CoreyButler.NVMforWindows

# В новом окне терминала
nvm install lts
nvm list
nvm use 24.11.1   # точный номер из вывода nvm list

Команда nvm use в Windows меняет системную ссылку, поэтому первый раз может попросить права администратора.

Файл .nvmrc в проекте

Положите в корень проекта файл .nvmrc с номером ветки, например 24. Тогда любой участник команды выполнит nvm use без аргументов и получит ту же версию, что и все. В nvm для Linux и macOS также работает nvm install без номера: версия берётся из этого файла.

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

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

node -v          # версия Node.js, например v24.11.1
npm -v           # версия npm
npx -v           # npx ставится вместе с npm
node -e "console.log(process.platform, process.arch)"

Чтобы узнать, откуда запускается node (полезно, когда версий несколько), используйте where node в Windows и which node в Linux и macOS. Если путь ведёт в ~/.nvm/ или %LOCALAPPDATA%\nvm, работает версия из nvm; если в C:\Program Files\nodejs или /usr/bin, системная.

Node.js в VS Code

Отдельно ставить Node.js "в VS Code" не нужно: редактор использует тот Node.js, что установлен в системе. Порядок такой:

1. Установите Node.js любым способом из статьи.
2. Полностью закройте VS Code (все окна), иначе он не увидит новый PATH.
3. Откройте VS Code и встроенный терминал сочетанием Ctrl + `.
4. Выполните node -v. Номер версии значит, что всё работает.
5. Для запуска файла откройте его и выполните в терминале node app.js или нажмите F5 и выберите "Node.js" в списке отладчиков.

Первые команды npm

npm (Node Package Manager) скачивает библиотеки из реестра npmjs.com и записывает зависимости проекта в package.json. Минимальный набор команд, который нужен каждый день:

Что делает npm install на практике: читает package.json, сверяет версии с package-lock.json, скачивает пакеты в папку node_modules и обновляет lock-файл. Папку node_modules не храните в репозитории, добавьте её в .gitignore (как это сделать, показано в шпаргалке по командам Git), а package.json и package-lock.json коммитьте обязательно.

Первый сервер на Node.js

Проверим установку на живом примере. Создайте папку, в ней файл server.js:

// server.js: простой HTTP-сервер без сторонних пакетов
import { createServer } from 'node:http';

const port = 3000;

const server = createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
  res.end(JSON.stringify({ ok: true, path: req.url, node: process.version }));
});

server.listen(port, () => {
  console.log(`Сервер запущен: http://localhost:${port}`);
});

Чтобы работал синтаксис import, выполните npm init -y и добавьте в package.json строку "type": "module". Запустите сервер командой node --watch server.js: флаг --watch сам перезапускает процесс при сохранении файла, nodemon для этого больше не нужен. Откройте в браузере http://localhost:3000/test и увидите JSON с версией Node.js. Остановить сервер можно сочетанием Ctrl + C.

Если вы пишете бэкенд на PHP, а Node.js нужен только для сборки CSS и JS, этого достаточно: npm install и npm run build в папке проекта. Тот же Node.js можно запускать в контейнере рядом с PHP, пример окружения есть в статье про Docker для PHP с Nginx и MySQL.

Частые ошибки при установке и npm install

Если npm install не работает и ошибка непонятная, помогает чистая переустановка зависимостей: удалите папку node_modules, выполните npm cache verify и снова npm install. Файл package-lock.json удаляйте только в крайнем случае, потому что после этого версии пакетов могут измениться.

Как обновить или удалить Node.js

• Установщик MSI или pkg: скачайте новую версию с сайта и установите поверх, настройки и глобальные пакеты сохранятся.
• winget: winget upgrade OpenJS.NodeJS.LTS.
• nvm: nvm install --lts, затем nvm uninstall 22 для ненужной ветки. Глобальные пакеты перенесёт ключ --reinstall-packages-from=current.
• NodeSource: для перехода на новую ветку запустите скрипт setup_XX.x с новым номером и выполните sudo apt install nodejs.
• Удаление в Windows: "Параметры → Приложения → Установленные приложения → Node.js → Удалить", затем вручную удалите папки %APPDATA%\npm и %LOCALAPPDATA%\npm-cache.

npm обновляется отдельно от Node.js командой npm install -g npm@latest, но обычно достаточно той версии, что пришла с LTS.