Node.js необходим для разработки современных веб-приложений, автоматизации задач и запуска серверного JavaScript-кода. На Mac OS существует несколько способов установки, каждый из которых подходит для разных сценариев. В этой инструкции рассматривается наиболее надёжный и гибкий метод – установка через Homebrew.
Перед началом убедитесь, что система обновлена: macOS версии не ниже 11.0 предпочтительна для стабильной работы последних версий Node.js. Также потребуется установленный Command Line Tools for Xcode, которые можно установить командой xcode-select --install.
Если Homebrew ещё не установлен, выполните команду /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". После установки обязательно выполните brew doctor для проверки корректности установки и устранения возможных конфликтов.
Для установки Node.js выполните brew install node. Эта команда установит как сам Node.js, так и npm – менеджер пакетов, без которого невозможно работать с экосистемой JavaScript. После установки проверьте версии с помощью команд node -v и npm -v.
Если требуется управлять несколькими версиями Node.js, установите nvm – Node Version Manager. Сначала загрузите скрипт установщика командой curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash, затем перезапустите терминал и проверьте доступность команды nvm. Теперь можно устанавливать нужные версии Node.js, например: nvm install 20.
Проверка установлен ли Node.js на вашем Mac
Откройте терминал через Spotlight или Launchpad. Введите команду:
node -v
Если установлен Node.js, отобразится его версия, например: v20.11.1. Это подтверждает наличие Node.js в системе.
Если вместо версии появится сообщение об ошибке, например command not found, Node.js не установлен или не добавлен в переменную среды PATH.
Для проверки установленного менеджера пакетов введите:
npm -v
При наличии Node.js будет выведена версия npm. Если команда не распознана, возможно установка прошла некорректно или требует переустановки.
Если Node.js установлен, но версия устарела, обновление можно выполнить через n или nvm, в зависимости от способа установки.
Удаление предыдущих версий Node.js перед новой установкой
Перед установкой новой версии Node.js важно удалить все следы предыдущих установок, особенно если ранее использовались разные способы установки – через Homebrew, nvm или ручную установку.
- Откройте терминал.
- Проверьте наличие установленного Node.js:
which node
node -v
which npm
- Если путь указывает на
/usr/local/bin/node, Node.js установлен вручную или через Homebrew.
- Удалите бинарные файлы:
sudo rm -rf /usr/local/bin/node
sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/local/bin/npx
- Удалите каталоги, связанные с Node.js:
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /usr/local/include/node
sudo rm -rf ~/.npm
sudo rm -rf ~/.node-gyp
- Проверьте наличие Node.js, установленного через Homebrew:
brew list node
- Если установлен, удалите:
brew uninstall node
- Если использовался nvm, выполните:
nvm deactivate
nvm uninstall <версия>
Замените <версия> на установленную (например, nvm uninstall 16.20.0). Чтобы увидеть список установленных версий:
nvm ls
- Удалите nvm, если он больше не нужен:
rm -rf ~/.nvm
Также удалите строки, добавленные в ~/.zshrc, ~/.bash_profile или ~/.bashrc, начинающиеся с export NVM_ и [ -s "$NVM_DIR/nvm.sh" ].
После всех шагов перезапустите терминал и убедитесь, что команды node и npm больше не распознаются.
Установка Node.js через менеджер версий nvm
Откройте терминал и проверьте наличие установленного curl или wget. Если они отсутствуют, установите с помощью brew install curl или brew install wget.
Скачайте и запустите установочный скрипт nvm командой:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Либо с использованием wget:
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
После установки откройте или перезапустите терминал. Проверьте, что nvm добавлен в конфигурационный файл оболочки. Для zsh это ~/.zshrc, для bash – ~/.bash_profile или ~/.bashrc. Убедитесь, что присутствует строка:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
Проверьте установку командой nvm --version.
Чтобы установить последнюю LTS-версию Node.js, выполните:
nvm install --lts
Для установки конкретной версии, укажите номер:
nvm install 18.19.1
Установленная версия становится активной автоматически. Проверить текущую можно через:
node -v
Для управления версиями используйте:
nvm ls – просмотр установленных версий
nvm use 18.19.1 – переключение на нужную
nvm alias default 18.19.1 – установка версии по умолчанию
Настройка переменных окружения для корректной работы Node.js
После установки Node.js важно убедиться, что переменные окружения настроены правильно. В macOS для этого редактируется профиль оболочки. Если используется zsh (по умолчанию с macOS Catalina), откройте файл ~/.zshrc в любом текстовом редакторе:
nano ~/.zshrc
Добавьте путь к Node.js и npm, если они не определены автоматически. Найдите путь к установленному Node.js через команду:
which node
Результат может выглядеть так: /opt/homebrew/bin/node. Убедитесь, что этот путь присутствует в переменной PATH:
export PATH="/opt/homebrew/bin:$PATH"
Сохраните изменения и примените их командой:
source ~/.zshrc
Для bash используйте файл ~/.bash_profile или ~/.bashrc и аналогичные действия.
Проверьте корректность настройки командой:
node -v и npm -v
Если версии отображаются, настройка выполнена верно. Для предотвращения конфликтов с другими версиями Node.js рекомендуется установить и использовать nvm (Node Version Manager). После установки nvm переменные NVM_DIR и обновлённый PATH прописываются автоматически. Проверка:
echo $NVM_DIR
Если переменная возвращает путь (например, /Users/имя_пользователя/.nvm), значит, nvm готов к использованию.
Проверка установленной версии и работоспособности Node.js
Откройте терминал и введите команду node -v. Эта команда выведет текущую установленную версию Node.js, например: v20.11.1. Если команда не распознана, Node.js установлен некорректно или не добавлен в переменную среды PATH.
Для проверки работы интерпретатора выполните команду node без параметров. В терминале появится интерактивная среда (REPL), готовая к вводу JavaScript-кода. Введите выражение console.log(«Node работает») и нажмите Enter. В ответ должно появиться: Node работает. Чтобы выйти из REPL, используйте сочетание клавиш Ctrl + C дважды.
Установка глобальных npm-пакетов для начала работы
После установки Node.js целесообразно установить несколько глобальных npm-пакетов, которые значительно упрощают разработку.
1. npm-check-updates
Позволяет обновлять зависимости в package.json до последних версий.
npm install -g npm-check-updates
2. nodemon
Автоматически перезапускает Node.js-приложение при изменении файлов.
npm install -g nodemon
3. eslint
Инструмент для анализа качества кода. Устанавливается глобально для создания конфигураций и быстрой инициализации.
npm install -g eslint
4. typescript
Если предполагается работа с TypeScript, глобальная установка компилятора обязательна.
npm install -g typescript
5. http-server
Минимальный HTTP-сервер для локального хостинга статических файлов.
npm install -g http-server
После установки проверьте доступность пакетов:
npx eslint --version
ncu --version
Глобальные пакеты устанавливаются в директорию, указанную командой:
npm root -g
Для избежания проблем с правами доступа рекомендуется использовать nvm или изменить директорию глобальных установок через npm config set prefix.
Вопрос-ответ:
Какой способ установки Node.js на Mac самый удобный для новичков?
Для тех, кто только начинает знакомство с Node.js, наиболее простой способ — использовать установщик с официального сайта nodejs.org. Он не требует дополнительных настроек и подходит для большинства задач. Достаточно скачать файл с расширением `.pkg`, открыть его и следовать инструкциям установщика. После этого Node.js и npm (менеджер пакетов) будут доступны из терминала. Этот вариант подойдет тем, кто не хочет разбираться с командной строкой на этапе установки.
Зачем устанавливать Node.js через Homebrew, если есть официальный установщик?
Установка через Homebrew дает больше гибкости. Во-первых, Homebrew позволяет легко обновлять Node.js до новых версий. Во-вторых, он помогает избегать конфликта с системными файлами, особенно если используется несколько версий Node.js. Такой подход удобен тем, кто уже работает с Homebrew для других задач и предпочитает управлять всеми пакетами в одном месте. Кроме того, Homebrew упрощает удаление и переустановку Node.js, если это потребуется.
После установки Node.js через Homebrew терминал пишет «command not found: node». Что делать?
Скорее всего, проблема в том, что путь к Node.js не добавлен в переменную окружения `PATH`. Сначала убедитесь, что Node.js действительно установлен, выполнив команду `brew list node`. Если он есть в списке, попробуйте закрыть и открыть терминал заново. Если это не помогает, проверьте содержимое файла `.zshrc` или `.bash_profile` (в зависимости от оболочки) и добавьте туда строку: `export PATH=»/opt/homebrew/bin:$PATH»`. Сохраните файл и выполните команду `source ~/.zshrc` или `source ~/.bash_profile`, чтобы изменения вступили в силу.
Как проверить, что Node.js установлен правильно?
Откройте терминал и выполните команду `node -v`. Если в ответ появится номер версии (например, `v20.12.1`), значит установка прошла успешно. Дополнительно можно проверить работу npm, выполнив команду `npm -v`. Она должна вернуть версию менеджера пакетов. Если обе команды работают, Node.js установлен корректно и готов к использованию.
Можно ли установить несколько версий Node.js и переключаться между ними?
Да, для этого можно использовать менеджеры версий, например `nvm` (Node Version Manager). С его помощью можно устанавливать разные версии Node.js и легко переключаться между ними, вводя команду `nvm use <версия>`. Это особенно полезно для разработчиков, работающих с проектами, которым требуются разные версии платформы. Установка `nvm` занимает немного времени, но в дальнейшем она позволяет удобно управлять средой разработки без конфликтов.
Как узнать, установлена ли Node.js на моём Mac и какая версия?
Откройте терминал и введите команду `node -v`. Если Node.js установлен, вы увидите номер текущей версии, например: `v20.11.0`. Если система выдаёт сообщение об ошибке или сообщает, что команда не найдена, значит Node.js не установлен. В таком случае нужно перейти к установке, например, через официальный сайт или с помощью менеджера пакетов Homebrew.
Можно ли установить несколько версий Node.js на Mac и переключаться между ними?
Да, можно. Для этого удобно использовать утилиту nvm (Node Version Manager). Она позволяет устанавливать разные версии Node.js и легко переключаться между ними. Сначала нужно установить nvm, выполнив команды из официальной инструкции в GitHub-репозитории проекта. После установки можно использовать, например, `nvm install 18` или `nvm use 20`, чтобы работать с нужной версией. Это особенно полезно при разработке разных проектов, где могут быть разные требования к версии Node.js.
Загрузка...
