Инструкция написана для Windows 11, в Windows 10 шаги такие же. Понадобятся права администратора — установщик ставит программу в общую папку и прописывает её в системный путь поиска команд. Весь дальнейший разговор с Node.js идёт через терминал, поэтому заранее откройте «Терминал Windows» или PowerShell.
Скачайте установщик линии LTS
Откройте официальный сайт Node.js. На главной странице предлагают две линии: с долгой поддержкой и текущую. Выбирайте LTS — на неё рассчитаны все инструменты и руководства, и обновления к ней выходят годами.
Скачайте установщик для Windows и 64-разрядной архитектуры; на ноутбуках с процессором ARM берите соответствующую сборку. Файл будет с расширением msi — это обычный установщик Windows.
Если вы привыкли к командной строке, тот же пакет можно поставить встроенным менеджером Windows — так проще потом обновлять:
winget install OpenJS.NodeJS.LTS
Пройдите установку
Запустите скачанный файл и нажимайте кнопку продолжения: принять условия лицензии, оставить папку по умолчанию, оставить набор компонентов как есть. В наборе уже отмечены сам Node.js, менеджер пакетов npm и добавление в системный путь — всё это нужно.
На отдельном шаге установщик предложит автоматически доустановить дополнительные инструменты для сборки пакетов из исходников. Галочку можно не ставить: она подтягивает крупные компоненты, которые понадобятся лишь редким библиотекам. Если такой пакет встретится, инструменты всегда можно поставить позже.
Проверьте, что всё работает
Закройте все открытые окна терминала и откройте новое — иначе он не узнает о новой команде. Спросите версии:
node -v
npm -v
Обе команды должны вывести номера версий. Если вместо этого терминал пишет, что команда не распознана, перезагрузите компьютер: иногда системный путь обновляется только после перезагрузки.
Запустите первый скрипт и поставьте первый пакет
Создайте папку проекта, а в ней текстовый файл с расширением js и одной строкой, которая выводит сообщение. Затем в терминале перейдите в эту папку и запустите файл командой node с именем файла — сообщение появится в терминале.
mkdir proba
cd proba
"console.log('Node.js работает')" | Out-File -Encoding utf8 index.js
node index.js
Теперь создайте файл описания проекта и поставьте первый пакет. Файл описания нужен, чтобы список зависимостей сохранился и на другом компьютере поставилось то же самое:
npm init -y
npm install dayjs
Рядом появится папка с зависимостями — она может быть большой, и её не хранят в репозитории: достаточно файлов описания, по ним всё скачивается заново.
Решите, нужен ли менеджер версий
Пока проект один, обычной установки достаточно. Как только появится второй проект, которому нужна другая версия Node.js, удобнее поставить менеджер версий — для Windows их несколько, они держат рядом несколько версий и переключают активную одной командой или сами, по файлу в папке проекта.
Перед установкой менеджера версий удалите Node.js, поставленный установщиком, иначе команды будут спорить за одно и то же имя. Обновлять версии после этого тоже нужно через менеджер.
Готово: Node.js и npm работают, первый скрипт запускается, пакеты ставятся, и вы знаете, что делать, когда проектам понадобятся разные версии.
Если что-то пошло не так
PowerShell отказывается запускать npm: сценарии отключены
Windows по умолчанию запрещает выполнение сценариев. Разрешите их только для своей учётной записи командой смены политики выполнения на вариант с проверкой подписи у скачанных файлов и подтвердите запрос. Через обычную командную строку npm работает и без этого.
Команда node не распознана
Откройте новое окно терминала, а если не помогло — перезагрузите компьютер. Если команда так и не появилась, проверьте в переменных среды, что путь к папке Node.js есть в системном пути, или переустановите программу, не снимая галочку про добавление в путь.
Установка пакета падает с ошибкой сборки
Значит, пакету нужны инструменты для сборки из исходников, которые вы не ставили. Посмотрите, нет ли у библиотеки готовой версии без сборки, или доустановите эти инструменты отдельно.
Проект требует другую версию Node.js
Посмотрите в файле описания проекта раздел с требованиями к версии. Поставьте менеджер версий, скачайте нужную версию и переключитесь на неё в папке проекта — переустанавливать всё заново не придётся.
Папка с зависимостями занимает слишком много места
Это нормально для Node.js. Её можно смело удалять у проектов, с которыми вы не работаете: по файлам описания всё восстановится командой установки зависимостей.
Комментарии · 0
Комментариев пока нет — задайте вопрос первым.