Как установить Node.js на Windows

Чтобы установить Node.js на Windows, обычно берут LTS-установщик с nodejs.org: он ставит node, npm и npx и сам прописывает их в PATH. Инструкция написана для Windows 11, на Windows 10 всё так же. Здесь же — winget, несколько версий Node.js на одном компьютере и ошибки, на которые новички натыкаются в PowerShell.

LTS или Current: какую версию брать

На nodejs.org две ветки. LTS (долгосрочная поддержка) годами получает исправления безопасности, и на неё рассчитаны почти все фреймворки и хостинги. В Current самые новые возможности, и она меняется раз в несколько недель. Берите LTS, если проект не требует другого. Сейчас это Node.js 24.

Установка Node.js из установщика .msi

Откройте https://nodejs.org/en/download, выберите LTS-версию, Windows и x64 (на компьютере с ARM-процессором — ARM64) и скачайте Windows Installer (.msi).
Запустите файл, примите лицензию и оставьте папку C:\Program Files\nodejs\.
На странице Custom Setup оставьте все компоненты, в том числе npm package manager и Add to PATH.
На странице Tools for Native Modules галочку не ставьте, если не уверены, что она нужна (об этом ниже). Нажмите Next, затем Install.

Установщик Node.js на странице Tools for Native Modules с пустой галочкой

Откройте новое окно «Терминала» и проверьте, что обе команды отвечают номером версии:

node -v
npm -v

Что ставит «Tools for Native Modules»

Некоторые пакеты npm содержат код на C или C++ и собираются прямо при установке. Для этого Windows нужны Python и Visual Studio Build Tools. Галочка Automatically install the necessary tools. Note that this will also install Chocolatey. после закрытия установщика открывает окно PowerShell, и оно ставит Python, Build Tools и менеджер пакетов Chocolatey. Это несколько гигабайт и заметное время.

Большинству веб-проектов это не нужно. Если позже установка пакета падает с gyp ERR! find VS, запустите установщик Node.js ещё раз с этой галочкой или сами поставьте Visual Studio с набором Desktop development with C++, как советует инструкция node-gyp.

Как поставить Node.js через winget

В Windows 11 уже есть winget. Эта команда ставит текущий LTS-выпуск из того же установщика с nodejs.org и ничего не спрашивает:

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

Закройте «Терминал», откройте снова и проверьте:

node -v

Несколько версий Node.js через nvm-windows

Если разным проектам нужны разные версии Node.js, возьмите NVM for Windows. Это отдельный проект Кори Батлера (Corey Butler), а не команды Node.js, и не та программа nvm, что на Mac и Linux. Сначала удалите Node.js, поставленный из .msi («Параметры › Приложения › Установленные приложения»), чтобы две копии не спорили за PATH. Потом скачайте установщик со страницы выпусков проекта на GitHub (github.com/coreybutler/nvm-windows) и запустите его от своего обычного пользователя, не от администратора.

nvm install 24
nvm use 24
node -v

Если npm или node не работает

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. — Windows PowerShell в Windows 11 и 10 по умолчанию не запускает скрипты, а npm там — небольшой скрипт. Либо пишите npm.cmd вместо npm, либо разрешите своему пользователю запускать локальные скрипты. Политика RemoteSigned по-прежнему не пускает неподписанные скрипты, скачанные из интернета. Команда — под списком.
'npm' is not recognized as an internal or external command, operable program or batch file. — откройте новое окно «Терминала»: PATH читается только при запуске. Если не помогло, проверьте, что C:\Program Files\nodejs\ есть в PATH, или запустите установщик ещё раз и выберите Repair.
Пакет, поставленный глобально через npm, «not recognized» — глобальные команды лежат в %AppData%\npm. Установщик добавляет эту папку в PATH вашего пользователя. Откройте новое окно или добавьте папку вручную, если удаляли её.
gyp ERR! find VS could not find a version of Visual Studio — пакет собирает машинный код. Поставьте инструменты, как описано в разделе про «Tools for Native Modules».

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Как обновить Node.js на Windows

Скачайте с nodejs.org новый .msi и запустите: он встанет поверх старой версии, а глобальные пакеты в %AppData%\npm останутся. В nvm-windows поставьте новую версию и переключитесь на неё, как в разделе про nvm-windows выше. Если ставили через winget, обновляйте через winget:

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

Если вы работаете и на Mac

MacWashing, раздел «Сборка мусора»: найдены мусор Xcode, пользовательский кэш, установщики и журналы, к очистке 22,83 ГБ

Сборка мусора в MacWashing находит кэш всех знакомых ей программ, в том числе спрятанный внутри их данных, а ещё журналы, мусор Xcode и остатки удалённых программ. Она показывает, сколько места занимает каждая находка, и очищает всё за один раз. Всё спорное остаётся без галочки, пока вы не решите.

Скачать MacWashing Как это работает

Бесплатная пробная версия · macOS 14 и новее

Вопросы и ответы

Как установить Node.js на Windows?

Скачайте с nodejs.org LTS-версию Windows Installer (.msi) и пройдите установку с настройками по умолчанию или поставьте его через winget: winget install --id OpenJS.NodeJS.LTS -e Потом проверьте в новом окне «Терминала»: node -v

npm ставится вместе с Node.js?

Да. В установщике есть npm и npx. Yarn или pnpm ставят отдельно, только если их использует проект.

Может, лучше WSL?

Если проект работает на Linux-сервере или нужны инструменты только для Linux, Node.js внутри WSL ведёт себя как на сервере. Для фронтенда и большинства пакетов хватает Node.js в самой Windows.