Как переключать версии Node.js в Windows с помощью NVM (пошаговое руководство)

Управление различными версиями Node.js в Windows может быть сложным, особенно когда каждый проект требует своей версии. NVM для Windows решает эту проблему, позволяя легко переключаться между версиями. Это руководство ясно объясняет, как установить и использовать NVM, выделяя распространенные проблемы установки и шаги по их устранению.
Ключевые моменты
- Используйте nvm-windows для быстрого переключения версий Node.js.
- Удалите предыдущие установки Node, чтобы избежать конфликтов.
- Запускайте команды в терминале администратора, чтобы предотвратить распространенные проблемы с правами доступа.
Установка NVM для Windows
Шаг 1: Удаление существующих установок Node
Перед установкой NVM удалите любые существующие версии Node.js, чтобы избежать конфликтов:
- Перейдите в Настройки > Приложения и удалите Node.js.
- Убедитесь, что папка
nodejs
не осталась вC:Program Filesnodejs
.
Установка nvm-windows
-
Скачайте последний релиз nvm-windows.
-
Запустите
nvm-setup.exe
и следуйте подсказкам (используйте расположения по умолчанию). -
Откройте новый терминал от имени администратора и проверьте установку:
nvm --version
Установка последних версий Node.js
После установки NVM вы можете легко управлять несколькими версиями Node.js:
- Для установки последней LTS (в настоящее время Node.js 22.x):
nvm install lts
- Для конкретной версии (например, Node.js 23.x):
nvm install 23.3.0
Список установленных версий Node:
nvm ls
Как переключать версии Node.js
После установки версий переключение очень просто:
- Для активации определенной версии:
nvm use 22.14.0
- Подтверждение активной версии:
node -v
npm -v
Устранение распространенных проблем с NVM
Проблема: NVM не переключает версии Node
Причина: Существует предыдущая установка Node.
Решение:
- Удалите или переименуйте существующую папку
C:Program Filesnodejs
. - Снова выполните
nvm use <версия>
.
Проблема: Ошибки прав доступа (доступ запрещен)
Причина: Создание символических ссылок требует повышенных привилегий.
Решение:
- Запустите командную строку от имени администратора, или
- Включите режим разработчика Windows (Настройки > Обновление и безопасность > Для разработчиков).
Проблема: Команда ‘nvm’ не найдена
Причина: Переменная среды Path не обновлена.
Решение: Закройте и снова откройте терминал или перезагрузите Windows.
Проблема: Глобальные пакеты npm отсутствуют после переключения
Причина: Глобальные пакеты зависят от конкретной версии.
Решение: Переустановите глобальные пакеты для каждой версии Node.js или используйте локальные установки (npx
).
Лучшие практики
- Документируйте версию Node для каждого проекта.
- Регулярно обновляйте nvm-windows и удаляйте неиспользуемые версии Node.
- Используйте версии Node LTS для стабильности.
Заключение
Использование nvm-windows упрощает управление несколькими версиями Node.js в Windows. Правильная настройка и устранение неполадок помогают избежать распространенных проблем, делая процесс разработки более гладким.
Часто задаваемые вопросы
Нет, оригинальный NVM предназначен для Linux и macOS. Пользователи Windows должны использовать nvm-windows.
Обычно это вызвано остатками установок Node. Удалите или переименуйте все существующие папки установки Node.
Да, если только вы не включили режим разработчика в Windows.
[TOGGLE question=""Как удалить версию Node из NVM?"" answer=""Используйте команду nvm uninstall <версия>
."" ]
Обычно в `%AppData%Roamingnvm`. Каждая версия устанавливается отдельно.