NPM. Depcheck

🧱 Суть

Со временем в проекте появляются зависимости, которые больше не используются:

• удалён старый код
• заменили библиотеку
• экспериментировали с пакетами
• забыли удалить временные зависимости

Такие пакеты увеличивают:

• размер node_modules
• время установки проекта
• количество потенциальных уязвимостей

📦 Проблема

Например, в package.json осталось:

{
  "dependencies": {
    "lodash": "^5.0.0",
    "axios": "^1.0.0"
  }
}

Но в коде:

import axios from 'axios';

а lodash нигде не используется.

Получается:

package.json
      ↓
лишний пакет
      ↓
загружает зависимости зря

✅ Решение

Использовать инструменты анализа зависимостей.

Один из популярных вариантов:

depcheck

Он проверяет:

• какие зависимости не используются
• какие зависимости используются, но отсутствуют в package.json

💻 Код

Проверка зависимостей через depcheck

Установка:

npm install -g depcheck

Запуск в корне проекта:

depcheck

Результат:

Unused dependencies (Неиспользуемые пакеты):

Unused dependencies
* lodash

Их можно удалить.

Missing dependencies (Используются в коде, но отсутствуют в package.json):

Missing dependencies
* date-fns

Ограничения depcheck

depcheck не всегда может правильно определить использование пакетов.

Проблемы возникают с:

• динамическими импортами:

import(`./modules/${name}`)

• alias-импортами:

import Button from '@/shared/ui/Button'

• конфигурационными файлами:

vite.config.ts

Поэтому результат нужно проверять вручную.

Удаление зависимостей

После проверки удаляем ненужный пакет:

npm uninstall имя_пакета

Например:

npm uninstall lodash

Можно удалить несколько сразу:

npm uninstall pkg1 pkg2 pkg3

Очистка зависимостей

После удаления можно полностью пересобрать зависимости:

rm -rf node_modules package-lock.json
 
npm install

Что произойдёт:

1. удалится старая папка node_modules
2. удалится lock-файл
3. npm заново установит зависимости

Настройка исключений

Если depcheck ошибочно считает пакет ненужным, можно добавить исключение.

Создать:

.depcheckrc

Пример:

{
  "ignores": [
    "mobx",
    "mobx-react-lite",
    "vite"
  ]
}

Теперь эти пакеты будут игнорироваться при проверке.

🎯 Вывод

• depcheck помогает найти лишние npm-зависимости
• удалять пакеты лучше только после проверки
• автоматические анализаторы могут ошибаться
• TypeScript alias’ы и динамические импорты нужно проверять вручную
• после чистки полезно пересобрать node_modules

🔗 Связано

• NPM. Обновление зависимостей
• Library. Prettier
• GitHub. CICD