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

Node.js — бесплатная среда выполнения JavaScript, а официальный установщик для Mac лежит на nodejs.org, npm входит в него. Разберём, какую версию выбрать, как установить и что проверить после этого.

Node.js

  • macOS 13.5 и новее
  • Один установщик для Apple Silicon и Intel
  • Бесплатно, открытый код
Официальный сайт Node.jsnodejs.org ↗

Или сразу установщик с сервера разработчика:

Ссылки ведут на сайт разработчика (nodejs.org). MacWashing с ним не связан и не хранит установщики у себя.

Откройте Терминал (Программы › Утилиты) и выполните:

brew install node

Homebrew скачает программу с сервера разработчика, проверит файл и положит программу в «Программы».

Homebrew ещё не установлен? Как установить Homebrew: одна команда с сайта brew.sh.

nvm (Node Version Manager) ставит Node.js в вашу домашнюю папку и переключает версии для разных проектов. Установите его командой из официального репозитория:

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

Закройте и снова откройте Терминал, затем установите LTS-версию и проверьте:

nvm install --lts
node -v

Если Терминал пишет nvm: command not found, выполните touch ~/.zshrc, повторите команду установки и откройте Терминал заново. Не смешивайте nvm с установщиком .pkg и Node из Homebrew: выберите что-то одно.

Какую версию скачать

На nodejs.org две линейки Node.js:

  • LTS (долгосрочная поддержка): поддерживается годами, её ждут большинство проектов и учебников. Если сомневаетесь, берите её.
  • Current: самые новые возможности. Новая основная версия выходит раз в полгода, и каждая чётная в октябре становится LTS.

Установщик для macOS — один .pkg для Mac с Apple Silicon и Intel, нужна macOS 13.5 или новее. Скачивайте его только с nodejs.org. Прямая ссылка в карточке ведёт на Current: у LTS постоянной ссылки нет, её берите на странице загрузки.

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

  1. На странице загрузки выберите версию и macOS, затем скачайте установщик (.pkg).
Первый экран установщика Node.js
  1. Откройте скачанный node-….pkg в папке Загрузки и нажмите Продолжить.
  2. Нажмите Продолжить и Принимаю, чтобы принять лицензию, затем Установить и введите пароль от Mac.
  3. Когда установщик сообщит, что Node.js и npm установлены в /usr/local/bin, нажмите Закрыть.

Что настроить после установки

Откройте новое окно Терминала и проверьте обе команды:

node -v
npm -v
  • npm входит в Node.js. Отдельно ставить его не нужно, npx тоже на месте.
  • Глобальные пакеты. С установкой из .pkg команда npm install -g пишет в системную папку и может упасть с ошибкой EACCES. Вместо sudo документация npm советует менеджер версий Node.js или другую папку для глобальных пакетов.
  • Кэш npm. npm хранит скачанные пакеты в ~/.npm, и папка растёт с каждым проектом.
  • Установщик. Когда node -v заработал, переместите .pkg из Загрузок в Корзину.

Если Node.js не устанавливается или не запускается

  • «command not found: node». Откройте новое окно Терминала. Если не помогло, проверьте, что echo $PATH показывает /usr/local/bin.
  • Установщик отказывается ставить Node.js. Проверьте версию macOS в окне Об этом Mac: текущему Node.js нужна macOS 13.5 или новее.
  • Две копии Node.js мешают друг другу. Если вы ставили Node.js и из .pkg, и через Homebrew, which node покажет, какая запускается. Оставьте одну.

Аналоги Node.js

Чтобы Mac оставался в порядке

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

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

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

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

Node.js бесплатный?

Да. Node.js и npm бесплатные и с открытым кодом.

Ставить установщиком или через Homebrew?

Установщик с nodejs.org — официальный способ. Homebrew ставит самую новую версию Node.js и обновляет её командой brew upgrade. Для линейки LTS у него есть формулы с номером, например node@24.

Нужно ли ставить npm отдельно?

Нет. npm ставится вместе с Node.js — и из .pkg, и через Homebrew.