Как удалить node_modules на Mac и не потерять проект

Отделите node_modules от проекта и кэша npm

node_modules — установленное дерево зависимостей проекта. Его можно пересоздать, пока сохранены все исходные данные и доступны нужные пакеты, но до переустановки проект не запустится и не соберётся. package.json, lock-файл, исходный код, конфигурация, файл .npmrc репозитория, патчи, настройки workspaces и история Git нужны для восстановления — удалять их нельзя. Общий кэш загрузок npm, обычно расположенный в ~/.npm, относится к другой категории и используется сразу несколькими проектами.

Убедитесь, что зависимости действительно восстановимы

Lock-файл делает разрешение зависимостей предсказуемым, но не хранит сами пакеты. Проверьте версию менеджера, учётные данные приватных реестров, VPN, доступ к зависимостям Git и file:, локальным пакетам workspaces, внешним загрузкам и инструментам сборки нативных модулей. npm v12 больше не читает npm-shrinkwrap.json: если в старом проекте это единственный lock-файл, переименуйте его в package-lock.json. Никогда не перезаписывайте уже существующий package-lock.json — сначала отдельно сравните и согласуйте оба файла. Правки, внесённые только в node_modules, после удаления исчезнут.

1. В корне проекта выполните pwd и du -sh ./node_modules, затем запишите объём свободного места в macOS.
2. Проверьте package.json, принятый lock-файл, конфигурацию workspaces и локальные изменения; для npm v12 переименуйте npm-shrinkwrap.json в package-lock.json, только если package-lock.json ещё не существует.
3. Убедитесь, что доступны приватные реестры, зависимости Git и file:, локальные пакеты, внешние загрузки и инструменты сборки, затем остановите процессы, использующие node_modules.
4. Переместите в Корзину только проверенную папку node_modules и переустановите зависимости из предусмотренного репозиторием корня с принятыми в нём менеджером и lock-файлом.
5. Запустите сборку, тесты, линтинг и приложение, повторно измерьте место и очищайте Корзину только после успешной проверки.

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

Удалите только одну проверенную папку зависимостей

В Finder переместите в Корзину только папку node_modules проверенного проекта, а не родительский репозиторий. Команда rm -rf ./node_modules в «Терминале» минует Корзину и удаляет необратимо, поэтому сначала проверьте корень проекта командой pwd. Не подставляйте в rm -rf непроверенный вывод find, маску или переменную. Если основной lock-файл — package-lock.json, используйте npm ci; для pnpm, Yarn или Bun применяйте закреплённый в репозитории менеджер и режим, запрещающий изменение lock-файла. В монорепозитории начинайте с корневого lock-файла и рассматривайте все workspaces как единую систему зависимостей. AskClean удаляет подтверждённые папки безвозвратно, без Корзины: если нужна возможность отката, сами переместите папку в Корзину в Finder и очищайте её только после успешной переустановки и сборки.

Переустановите зависимости и проверьте весь проект

Успешная установка ещё не доказывает, что проект восстановлен. Запустите предусмотренные репозиторием команды сборки, тестов, линтинга и запуска: нативные модули и скрипты жизненного цикла могут сломаться после смены Node.js, macOS или инструментов. Восстановление потребует загрузки и распаковки пакетов, создания ссылок, запуска скриптов и иногда компиляции. При ошибке верните папку из Корзины и проверьте доступ, сеть, версии и lock-файл, прежде чем чистить следующий проект.

Границы удаления и стоимость восстановления

Найдите крупные папки node_modules на Mac, сохраните исходный код и lock-файл, затем безопасно переустановите зависимости с помощью npm, pnpm, Yarn или Bun.

Частые вопросы