Как полностью удалить Node.js и переустановить заново на Mac OS X

Полное удаление Node.js и npm на macOS

Проблема, с которой вы столкнулись, очень распространена среди начинающих разработчиков. "Грязная" установка поверх старой версии приводит к конфликтам модулей и бинарников. Вот проверенный способ полного удаления с последующей чистой установкой.

Шаг 1: Удаление всех бинарников и модулей

Запустите в терминале следующие команды. Они удалят все файлы Node.js, npm и глобальные пакеты:

# Удаляем бинарники
sudo rm -rf /usr/local/bin/node
sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/local/bin/npx

# Удаляем глобальные модули и библиотеки
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /usr/local/lib/node

# Удаляем конфигурационные файлы пользователя
rm -rf ~/.npm
rm -rf ~/.node-gyp
rm -rf ~/.node_repl_history

# Удаляем кэш и временные файлы
sudo rm -rf /usr/local/share/man/man1/node*
sudo rm -rf /usr/local/share/man/man1/npm*
sudo rm -rf /usr/local/share/systemtap/tapset/node.stp
sudo rm -rf /opt/local/bin/node
sudo rm -rf /opt/local/bin/npm
sudo rm -rf /opt/local/lib/node_modules

Важно: Команды с sudo требуют пароль администратора. Будьте внимательны, чтобы не удалить лишнего.

Шаг 2: Проверка, что всё удалено

После выполнения команд проверьте, что Node.js и npm больше не доступны:

which node
# Должно вернуть: node not found
which npm
# Должно вернуть: npm not found

node -v
# Должно вернуть: -bash: node: command not found

Шаг 3: Установка Node.js через nvm (рекомендуемый способ)

Вместо установки через официальный инсталлятор, я рекомендую использовать nvm (Node Version Manager). Это позволит легко переключаться между версиями и избежать проблем в будущем:

# Устанавливаем nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Перезапускаем терминал или выполняем:
source ~/.zshrc  # или source ~/.bash_profile

# Устанавливаем последнюю стабильную версию Node.js
nvm install --lts

# Проверяем установку
node -v
npm -v

Шаг 4: Настройка глобальных пакетов

Теперь вы можете устанавливать глобальные пакеты, и они будут работать корректно:

npm install -g create-react-app
npm install -g nodemon
npm install -g typescript

Почему это работает?

Проблема была в том, что при установке поверх старой версии, бинарники и модули конфликтовали. nvm хранит каждую версию Node.js в отдельной папке ~/.nvm и просто подменяет пути в переменной окружения PATH. Это гарантирует чистоту установки и возможность легко откатиться на другую версию.

После выполнения всех шагов, ваша система будет чиста от старых файлов Node.js, и вы сможете работать без ошибок. В будущем для обновления Node.js достаточно выполнить nvm install --lts, а для смены версии — nvm use 18.

# Сначала удаляем Node.js, установленный через Homebrew
brew uninstall --ignore-dependencies node
brew uninstall --force node

# Очищаем кэш и временные файлы
brew cleanup

# Удаляем остатки вручную
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /usr/local/include/node
sudo rm -rf /usr/local/lib/node
rm -rf ~/.npm

# Обновляем Homebrew
brew update

# Устанавливаем Node.js
brew install node

# Проверяем
node -v
npm -v