Ошибка "Could not find a declaration file for module" в TypeScript: решение

Причина ошибки

TypeScript — это строго типизированный язык. Когда вы импортируете JavaScript-модуль (например, lodash), компилятору нужна информация о типах его функций, классов и переменных. Эта информация хранится в файлах деклараций с расширением .d.ts. Если такого файла нет, TypeScript считает модуль имеющим тип any и выдает ошибку (при включенном strict или noImplicitAny).

Решение: установка пакета с типами

Для большинства популярных библиотек существуют отдельные пакеты с декларациями. Они находятся в репозитории @types на npm и устанавливаются как dev-зависимости.

Для lodash выполните команду:

npm install --save-dev @types/lodash

После установки TypeScript автоматически найдет файл декларации в node_modules/@types/lodash. Ошибка исчезнет, и вы получите автодополнение и проверку типов:

import _ from 'lodash';

const arr: number[] = [1, 2, 3];
const shuffled: number[] = _.shuffle(arr); // теперь TypeScript знает тип результата
console.log(shuffled);

Что делать, если пакета @types нет?

Некоторые библиотеки не имеют отдельного пакета с типами. В таком случае есть три варианта:

• Создать свой файл декларации — в корне проекта создайте файл declarations.d.ts и напишите:

  declare module 'имя-модуля';

  Это объявит модуль с типом any (временное решение).
• Написать полноценную декларацию — если вы хотите точную типизацию, изучите API библиотеки и опишите её вручную. Например:

  declare module 'my-custom-lib' {
    export function doSomething(input: string): number;
  }

• Отключить проверку для конкретного модуля — в tsconfig.json добавьте:

  {
    "compilerOptions": {
      "noImplicitAny": false
    }
  }

  Но это глобально отключит проверку типов для всех значений any, что не рекомендуется.

Проверка наличия типов

Перед установкой можно проверить, есть ли типы для библиотеки на сайте TypeScript DT Search. Или выполнить команду:

npm info @types/имя-библиотеки

Важные моменты

• Устанавливайте @types/* как dev-зависимости (--save-dev), так как они нужны только во время разработки.
• Некоторые библиотеки (например, express, react) уже содержат встроенные типы — в их package.json есть поле "types". В этом случае дополнительная установка не требуется.
• Если вы используете yarn, команда будет: yarn add --dev @types/lodash.

Пример полного решения

// 1. Установка
npm install lodash
npm install --save-dev @types/lodash

// 2. Использование
import _ from 'lodash';

const result: number[] = _.shuffle([1, 2, 3]);
console.log(result); // OK

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": false // отключает проверку типов для JS-файлов
  }
}