Ошибка "Could not find a declaration file for module" в TypeScript — как исправить?

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

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

Решение: три способа

1. Установка @types/пакета (рекомендуется)

Многие популярные библиотеки имеют отдельные пакеты с декларациями в DefinitelyTyped. Для lodash это работает так:

npm install --save-dev @types/lodash

После установки TypeScript автоматически найдёт файлы деклараций в node_modules/@types/lodash, и ошибка исчезнет. Для проверки наличия типов для вашего модуля используйте поиск: npm info @types/ваш-модуль или посетите TypeScript Search.

2. Создание собственного файла декларации

Если типов нет в DefinitelyTyped или вы используете внутренний модуль, создайте файл declarations.d.ts (имя может быть любым) в корне проекта:

// declarations.d.ts
declare module 'lodash' {
  export function shuffle<T>(array: T[]): T[];
  // можно описать полный интерфейс или оставить any:
  // export function shuffle(array: any[]): any[];
}

Важно: чтобы TypeScript подхватил этот файл, он должен быть включён в include или files вашего tsconfig.json. Обычно достаточно:

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./types"]
  },
  "include": ["src/**/*", "declarations.d.ts"]
}

3. Отключение noImplicitAny (не рекомендуется)

Это временное решение, которое отключает строгую типизацию:

// tsconfig.json
{
  "compilerOptions": {
    "noImplicitAny": false
  }
}

Но это снижает безопасность кода: вы не получите подсказки IDE и можете допустить ошибки во время выполнения.

Почему одни модули работают без @types?

Некоторые библиотеки (например, express) содержат встроенные файлы деклараций — в их package.json есть поле "types", указывающее на .d.ts файл. У lodash такого поля нет, поэтому нужны внешние типы.

Дополнительные советы

• Проверьте tsconfig.json: убедитесь, что moduleResolution установлен в "node" (по умолчанию).
• Используйте skipLibCheck: true в опциях компилятора — это ускорит сборку, но не решит проблему с отсутствием типов.
• Для глобальных модулей (без импорта) создайте файл globals.d.ts и объявите модуль с declare module 'lodash'.

{
  "compilerOptions": {
    "allowUmdGlobalAccess": true,
    "module": "commonjs" // или "esnext"
  }
}

// any-declarations.d.ts
declare module 'lodash' {
  const _: any;
  export default _;
}

// в node_modules/lodash/package.json
{
  "types": "index.d.ts" // если есть — типы уже установлены
}