Установка и настройка Node.js на Windows 11 23H2

Полное руководство по установке, базовой настройке и оптимизации Node.js для разработки под Windows 11

Введение

Node.js - среда выполнения JavaScript для серверной разработки. Это руководство покажет:

• Установку актуальной LTS-версии
• Настройку окружения разработки
• Решение частых проблем
• Оптимизацию работы npm

Требования

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

• Windows 11 версии 23H2 (сборка 22621+)
• 500 МБ свободного места на диске
• Права администратора
• Обновлена версия .NET Framework 4.5.2+

Установка

Подготовка

1. Скачайте установщик с официального сайта
2. Выберите версию с пометкой LTS
3. Проверьте хеш SHA-256 скачанного файла:

1Get-FileHash -Path .\node-v20.12.2-x64.msi -Algorithm SHA256

Процесс установки

1. Запустите установщик от имени администратора
2. В мастере установки:
   • Отметьте Automatically install necessary tools
   • Выберите компоненты:

     Node.js runtime
     npm package manager
     Add to PATH
     

3. Укажите путь установки (рекомендуется оставить по умолчанию: C:\Program Files\nodejs)
4. Завершите установку и перезагрузите систему

Настройка

После установки:

1. Проверьте версии:

1node --version
2npm --version

2. Настройте глобальный кэш npm:

1npm config set cache "C:\Users\%USERNAME%\AppData\Roaming\npm-cache" --global

3. Обновите npm:

npm install -g npm@latest

4. Установите менеджер версий:

npm install -g nvm-windows

Типичные ошибки и их решения

Ошибка: 'node' не распознана как команда

• Решение: Перезапустите терминал или проверьте PATH

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

• Решение: Запустите консоль от администратора

Ошибка: Python не найден

• Решение: Установите Windows Build Tools:

npm install --global windows-build-tools

Заключение

Теперь вы готовы к работе с Node.js. Для проверки создайте тестовый скрипт:

1// server.js
2const http = require('http');
3http.createServer((req, res) => {
4  res.writeHead(200);
5  res.end('Hello Node.js!');
6}).listen(3000);

Запустите приложение:

node server.js

Команды

Проверка версии Node.js

1node --version

Установка глобального пакета

1npm install -g <package-name>

Очистка кэша npm

1npm cache clean --force

Решение проблем

Сбой при установке native-модулей

Установите Visual Studio Build Tools с компонентом C++

1choco install -y visualstudio2022buildtools

Долгая установка пакетов

Смените реестр npm на Yarn или установите зеркало

1npm set registry https://registry.npmmirror.com