Как установить Node.js на Windows: пошаговая инструкция

Введение

Node.js — среда выполнения JavaScript на стороне сервера, без которой не обходится ни один современный проект на React, Vue, Next.js или Express. Установка Node.js на Windows — первый шаг для любого JavaScript-разработчика. В этой статье разберём два основных способа: через официальный установщик и через менеджер версий nvm-windows.

Что такое Node.js и зачем он нужен

Node.js позволяет запускать JavaScript за пределами браузера. Вместе с ним устанавливается npm — менеджер пакетов, открывающий доступ к сотням тысяч библиотек. Без Node.js невозможно работать с современными фронтенд-инструментами: сборщиками, линтерами, серверными фреймворками.

Требования перед установкой

Перед установкой убедитесь, что:

• Версия Windows: 10 или 11 (64-bit)
• Есть права администратора на компьютере
• Доступно стабильное интернет-соединение
• На диске есть минимум 500 МБ свободного места

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

Это самый простой способ, подходящий для большинства разработчиков, которые работают над одним проектом.

Шаг 1: Скачайте установщик

Перейдите на официальный сайт nodejs.org и скачайте LTS-версию. LTS (Long Term Support) — стабильная версия с долгосрочной поддержкой, рекомендуется для большинства задач.

Шаг 2: Запустите установку

Запустите скачанный .msi файл и следуйте инструкциям мастера:

1. Нажмите Next на экране приветствия
2. Примите лицензионное соглашение
3. Оставьте путь установки по умолчанию: C:\Program Files\nodejs\
4. Не снимайте галочку с компонента npm
5. Нажмите Install

Шаг 3: Проверьте установку

Откройте PowerShell или Command Prompt и выполните:

# Проверяем версию Node.js
node --version

# Проверяем версию npm
npm --version

Если вы видите номера версий (например, v20.11.0 и 10.2.4), установка прошла успешно.

Способ 2: Установка через nvm-windows

nvm-windows (Node Version Manager for Windows) — инструмент для управления несколькими версиями Node.js. Подходит, если вы работаете над несколькими проектами с разными требованиями к версии.

Установка nvm-windows

1. Перейдите на страницу релизов nvm-windows на GitHub
2. Скачайте файл nvm-setup.exe из последнего релиза
3. Запустите установщик и следуйте инструкциям
4. После установки перезапустите терминал

Основные команды nvm-windows

Откройте PowerShell с правами администратора и выполните нужные команды:

# Просматриваем доступные версии Node.js
nvm list available

# Устанавливаем конкретную версию
nvm install 20.11.0

# Устанавливаем последнюю LTS-версию
nvm install lts

# Переключаемся на нужную версию
nvm use 20.11.0

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

Переключение между версиями

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

# Устанавливаем две версии
nvm install 18.19.0
nvm install 20.11.0

# Переключаемся на версию 18 для старого проекта
nvm use 18.19.0

# Проверяем текущую версию
node --version
# Вывод: v18.19.0

# Возвращаемся на версию 20 для нового проекта
nvm use 20.11.0

Настройка npm после установки

Обновление npm

npm обновляется независимо от Node.js:

# Обновляем npm до последней версии
npm install -g npm@latest

# Проверяем версию после обновления
npm --version

Настройка глобальной директории пакетов

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

# Создаём папку для глобальных пакетов
mkdir %USERPROFILE%\npm-global

# Указываем npm использовать эту папку
npm config set prefix "%USERPROFILE%\npm-global"

После этого добавьте %USERPROFILE%\npm-global в переменную среды PATH через Параметры системы → Переменные среды → Path.

Частые ошибки

'node' is not recognized as an internal or external command

Причина: Node.js не добавлен в переменную PATH.

Решение:

1. Откройте Параметры системы → Дополнительные параметры системы → Переменные среды
2. В разделе Системные переменные найдите Path и нажмите Изменить
3. Добавьте путь C:\Program Files\nodejs\
4. Перезапустите терминал

# Проверяем, что путь добавлен корректно
echo %PATH%

Ошибка EACCES при глобальной установке пакетов

При выполнении npm install -g появляется ошибка прав доступа:

# Запускаем PowerShell от имени администратора
# Затем устанавливаем пакет глобально
npm install -g typescript

Либо используйте метод с настройкой глобальной директории из раздела выше — это более правильное долгосрочное решение.

nvm use не меняет версию Node.js

При использовании nvm-windows обязательно запускайте терминал от имени администратора. Иначе команда nvm use не сможет создать нужную символическую ссылку и версия не переключится.

Конфликт с ранее установленным Node.js

Если вы устанавливаете nvm-windows поверх существующей установки, сначала полностью удалите старый Node.js:

# После удаления через "Установку и удаление программ" вручную очищаем остатки
# Удаляем директорию Node.js
rmdir /s /q "C:\Program Files\nodejs"

# Удаляем кэш и глобальные пакеты npm
rmdir /s /q "%APPDATA%\npm"
rmdir /s /q "%APPDATA%\npm-cache"

Заключение

Для большинства начинающих разработчиков оптимален официальный установщик с LTS-версией — он быстрый и не требует дополнительной настройки. Если вы работаете с несколькими проектами или хотите гибко переключаться между версиями Node.js, выбирайте nvm-windows. После любого способа установки проверьте работу команд node и npm в терминале и настройте глобальную директорию пакетов, чтобы избежать проблем с правами доступа в будущем.