Как установить Node.js на macOS: официальный установщик, Hom

Короткий ответ: если вы новичок, скачайте LTS-установщик с nodejs.org, установите его как обычную программу и проверьте node -v и npm -v в Terminal. Если вы работаете с несколькими проектами, лучше использовать nvm, потому что он позволяет переключать версии Node.js без переустановки

Материал закрывает запрос «как установить node js на mac os» и соседние хвосты про установку Node.js на Mac. Интент обычно такой: пользователь открыл Mac, видит терминал, Homebrew, nvm, официальный сайт и не понимает, какой вариант выбрать

Содержание

Вариант 1: официальный установщик
Вариант 2: установка через Homebrew
Вариант 3: установка через nvm
Какой способ выбрать
Первый запуск после установки
Где открывать терминал
Мини-практика
Частые ошибки
Что почитать дальше по Node.js

Вариант 1: официальный установщик

Зайдите на официальный сайт

https://nodejs.org

Скачайте LTS-версию для macOS. Обычно это файл .pkg. Запустите установщик, пройдите шаги мастера и дождитесь завершения

После установки откройте Terminal и выполните

node -v
npm -v

Если команды показывают версии, установка прошла успешно

Этот способ проще всего для первого урока. Его минус в том, что переключать версии Node.js между проектами будет неудобно

Вариант 2: установка через Homebrew

Если Homebrew уже установлен, можно поставить Node.js так

brew install node

Проверка такая же

node -v
npm -v

Homebrew удобен тем, кто уже пользуется пакетным менеджером на macOS. Но для разработки на нескольких версиях Node.js все равно часто выбирают nvm

Вариант 3: установка через nvm

nvm — менеджер версий Node.js. Он полезен, когда один проект требует Node.js 18, другой — Node.js 20, а третий пока работает только на старой версии

После установки nvm можно поставить LTS-версию

nvm install --lts
nvm use --lts

Проверка

node -v
npm -v

Если вы только учитесь, nvm может показаться лишним. Но если планируете запускать разные проекты из уроков, GitHub или рабочих задач, этот вариант быстро окупается

Какой способ выбрать

Для первого запуска выбирайте официальный .pkg. Для более серьезной разработки выбирайте nvm. Homebrew хорош, если вы уже используете его как основной способ установки программ на macOS

Главное — не смешивать все способы сразу. Если поставить Node.js через .pkg, потом через Homebrew, потом через nvm, можно получить путаницу: терминал будет запускать не ту версию, которую вы ожидаете

Первый запуск после установки

Создайте папку

mkdir node-mac-demo
cd node-mac-demo

Создайте файл index.js

console.log("Node.js работает на macOS");
console.log(process.version);

Запустите

node index.js

Ожидаемый вывод будет примерно таким

Node.js работает на macOS
v20.11.1

Версия может быть другой, это нормально

Где открывать терминал

На macOS можно открыть Terminal через Spotlight: нажмите Command + Space, введите Terminal и нажмите Enter. Если вы работаете в Visual Studio Code, откройте папку проекта и используйте встроенный терминал через меню Terminal

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

Мини-практика

Установите Node.js выбранным способом, проверьте версии, создайте index.js и выведите process.version. Затем создайте package.json через

npm init -y

Если файл package.json появился, npm тоже работает

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

После установки команда node не найдена Закройте Terminal и откройте его заново. Если не помогло, проверьте, каким способом ставили Node.js и что показывает which node

Установлены две разные версии Проверьте

which node
node -v

Если используете nvm, убедитесь, что активировали нужную версию через nvm use

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

Скачан не тот установщик Для обычного Mac нужен установщик macOS. Если сомневаетесь в архитектуре, официальный сайт обычно сам предлагает подходящий вариант

Что почитать дальше по Node.js

Если нужен общий маршрут по теме, откройте рубрику Node.js. Для соседних задач пригодятся эти разборы:

Как установить Node.js на macOS: официальный установщик, Homebrew и nvm