<- Назад к постам и статьям Установка Node.js и настройка PATH

Пошаговая инструкция: как правильно установить Node.js, npm и проверить работу на Windows, macOS и Linux.

#Programming Node.js Windows · macOS · Linux
Node.js installation and PATH setup article cover

Node.js нужен для запуска JavaScript вне браузера, серверной разработки и работы с пакетами через npm. Для удобной работы важно, чтобы команды node и npm были доступны из любой папки.

📦

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

Node.js — это среда выполнения JavaScript вне браузера. PATH — переменная среды, которая позволяет системе находить исполняемые файлы. Если Node.js добавлен в PATH, команды node и npm работают в любой папке.

✅ Node.js LTS 📦 npm included 🖥️ Windows · macOS · Linux 1

Скачайте установщик Node.js

Откройте официальный сайт nodejs.org. Для большинства случаев выбирайте LTS — это стабильная версия с долгосрочной поддержкой.

  • LTS подходит для учебы и большинства реальных проектов.
  • Current обычно нужен только тем, кто тестирует самые новые возможности.
Совет: скачивайте Node.js только с официального сайта. 2

Установка на Windows

Запустите скачанный .msi-файл. На Windows Node.js обычно сам добавляет себя в PATH.

  1. 1

    Примите лицензию

    Пройдите стандартные шаги установки.

  2. 2

    Оставьте путь по умолчанию

    Обычно это оптимальный вариант.

  3. 3

    Проверьте Add to PATH

    Эта опция должна быть включена.

  4. 4

    Завершите установку

    После этого откройте новый терминал.

Важно: не отключайте Add to PATH, иначе команды node и npm могут не заработать. 3

Проверьте установку

Откройте PowerShell, cmd или терминал и выполните:

node --version
npm --version

Если вы видите версии, Node.js и npm установлены правильно.

Если команды не распознаются: переоткройте терминал или перезагрузите компьютер, затем проверьте PATH. 4

Установка на macOS

Способ 1: установить официальный .pkg с сайта Node.js.

Способ 2: использовать Homebrew:

brew install node
node --version
npm --version
Примечание: для разработчиков Homebrew обычно удобнее, потому что упрощает обновления. 5

Установка на Linux

На Linux можно использовать пакетный менеджер или NodeSource для более свежей LTS-версии.

Ubuntu / Debian через NodeSource:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Через стандартный пакетный менеджер:

sudo apt update
sudo apt install nodejs npm

Fedora:

sudo dnf install nodejs npm
6

Что делать, если Node.js не добавлен в PATH

На Windows путь можно добавить вручную через переменные среды.

  1. Найдите папку установки, обычно C:\Program Files\nodejs\.
  2. Откройте sysdm.cpl → Дополнительно → Переменные среды.
  3. Откройте переменную Path.
  4. Добавьте C:\Program Files\nodejs\.
  5. Откройте новый терминал и снова проверьте команды.
Альтернатива: переустановите Node.js, убедившись, что Add to PATH включён. 7

Используйте nvm для нескольких версий Node.js

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

macOS / Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Windows: установите nvm-windows.

После установки можно делать так:

nvm install 20
nvm use 20
nvm list
Плюс nvm: он сам переключает PATH под выбранную версию Node.js. 8

Первые шаги с npm

Проверьте npm на простом примере:

npm init -y
npm install express

После этого появятся package.json, package-lock.json и папка node_modules.

Совет: глобальные пакеты ставятся через npm install -g пакет, но для проектов чаще нужны локальные зависимости. ⚠️

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

  • node не распознаётся — PATH не настроен.
  • npm не найден — обычно помогает переустановка Node.js.
  • Ошибка прав доступа при глобальной установке — используйте nvm или настройте глобальные пакеты аккуратно.
  • Конфликт версий — используйте nvm для разных проектов.
Node.js + npm достаточно, чтобы начать писать серверный JavaScript и запускать сборщики. После изменения PATH всегда открывайте терминал заново. Документация: nodejs.org/docs.

Первая проверка: создайте файл app.js с кодом console.log("Hello, Node!"); и запустите его командой node app.js.