How to fix Could not find a declaration file for module 'lodash' in TypeScript

What this error means

The "Could not find a declaration file for module 'lodash'" error (TS7016) appears when TypeScript cannot find type definitions (.d.ts files) for the lodash module. Lodash is a JavaScript library written before TypeScript became popular, so it doesn't include built-in type definitions in its main package. TypeScript needs type information to provide type checking, autocomplete, and other language features. When you import a JavaScript library without types, TypeScript treats all its exports as having the 'any' type, which defeats the purpose of using TypeScript and can lead to runtime errors. The TypeScript community maintains type definitions for popular JavaScript libraries in the DefinitelyTyped repository. These are published as @types packages on npm. For lodash, you need to install @types/lodash as a development dependency to get full type safety and IDE support. This error commonly occurs after installing lodash but forgetting the types package, or when migrating a JavaScript project to TypeScript.

Typical symptoms

• Compilation fails with 'Could not find a declaration file for module 'lodash''
• Error code TS7016 appears in TypeScript compiler output
• Red underlines appear in IDE on lodash import statements
• Lodash functions show as type 'any' instead of proper types
• Autocomplete doesn't work for lodash methods in your editor
• Project builds successfully but TypeScript shows errors in development

Common causes

1. The @types/lodash package is not installed in your project
2. The @types/lodash package is installed but in the wrong location (e.g., wrong workspace in monorepo)
3. TypeScript compiler cannot find the @types directory (typeRoots misconfigured)
4. Using lodash-es instead of lodash without matching @types package
5. Version mismatch between lodash and @types/lodash packages
6. Types package excluded in tsconfig.json or .gitignore'd node_modules/@types

How to fix "Could not find a declaration file for module 'lodash'"

# Using npm
npm install --save-dev @types/lodash

# Using yarn
yarn add --dev @types/lodash

# Using pnpm
pnpm add -D @types/lodash

// This will now have full type support
import _ from "lodash";
import { debounce, groupBy } from "lodash";

const numbers = [1, 2, 3, 4];
const doubled = _.map(numbers, n => n * 2);  // Type: number[]

# Verify the package exists
npm list @types/lodash

# Check node_modules structure
ls -la node_modules/@types/lodash

# View package.json to confirm it's listed
cat package.json | grep "@types/lodash"

└── @types/lodash@X.Y.Z

# For npm workspaces
npm install --workspace=packages/my-app --save-dev @types/lodash

# For yarn workspaces (install from the specific workspace directory)
cd packages/my-app && yarn add --dev @types/lodash

{
  "compilerOptions": {
    "typeRoots": [
      "./node_modules/@types"
    ],
    "types": [],  // Empty array means include all @types packages
    "moduleResolution": "node",
    "esModuleInterop": true
  }
}

{
  "compilerOptions": {
    "typeRoots": [
      "./node_modules/@types",
      "./custom-types"  // Any additional custom type directories
    ]
  }
}

{
  "compilerOptions": {
    // WRONG - this excludes lodash types
    "types": ["node", "jest"]

    // CORRECT - include lodash explicitly if using types field
    "types": ["node", "jest", "lodash"]
  }
}

npm install --save-dev @types/lodash-es

// For lodash (CommonJS)
import _ from "lodash";
import { debounce } from "lodash";  // Types from @types/lodash

// For lodash-es (ES Modules)
import _ from "lodash-es";
import { debounce } from "lodash-es";  // Types from @types/lodash-es

# Remove node_modules and lock files
rm -rf node_modules
rm package-lock.json  # or yarn.lock / pnpm-lock.yaml

# Clear package manager cache
npm cache clean --force
# or
yarn cache clean
# or
pnpm store prune

# Reinstall all dependencies
npm install

# Restart dev server
npm run dev

# In VS Code, restart TypeScript
# Cmd/Ctrl + Shift + P → "TypeScript: Restart TS Server"

// types/lodash.d.ts
declare module "lodash" {
  const _: any;
  export = _;
}

// Or with basic types:
declare module "lodash" {
  export function map<T, U>(
    collection: T[],
    iteratee: (value: T) => U
  ): U[];

  export function debounce<T extends (...args: any[]) => any>(
    func: T,
    wait?: number
  ): T;

  // Add other functions you use...
}

{
  "include": [
    "src/**/*",
    "types/**/*"
  ]
}

Advanced notes

{
  "dependencies": {
    "lodash": "^4.17.21"
  },
  "devDependencies": {
    "@types/lodash": "^4.14.200"  // Major version matches
  }
}

// Entire lodash library
import _ from "lodash";

// Specific function (CommonJS)
import debounce from "lodash/debounce";

// Specific function (ES Modules with lodash-es)
import { debounce } from "lodash-es";

{
  "compilerOptions": {
    "skipLibCheck": true  // Skips type checking for all .d.ts files
  }
}

// BAD - imports entire lodash library (~70KB)
import _ from "lodash";
_.map([1, 2, 3], x => x * 2);

// GOOD - imports only map function
import map from "lodash/map";
map([1, 2, 3], x => x * 2);

// BEST - use lodash-es with named imports
import { map } from "lodash-es";
map([1, 2, 3], x => x * 2);

// Without @types/lodash
import _ from "lodash";  // _ has type 'any'

const result = _.map([1, 2], x => x * 2);  // result: any, x: any

// With @types/lodash
import _ from "lodash";  // _ has proper lodash types

const result = _.map([1, 2], x => x * 2);  // result: number[], x: number

# Find all imports from packages
grep -r "from ['"]" src/ | grep -v node_modules | cut -d"'" -f2 | sort -u

# Check which need @types
for pkg in $(cat package.json | jq -r '.dependencies | keys[]'); do
  npm search @types/$pkg --json | jq -r '.[0].name'
done

npm install --save-dev @types/lodash @types/express @types/node

Frequently asked questions

What does "TS7016" mean?

ts files) for the lodash module. Lodash is a JavaScript library written before TypeScript became popular, so it doesn't include built-in type definitions in its main package. TypeScript needs type information to provide type checking, autocomplete, and other language features.

How do I fix "TS7016"?

This TypeScript error occurs when you import lodash (or similar JavaScript libraries) without the corresponding type definitions installed. The fix is to install the @types/lodash package, which provides TypeScript type declarations for lodash's functions and modules.

What causes "TS7016"?

The @types/lodash package is not installed in your project The @types/lodash package is installed but in the wrong location (e.g., wrong workspace in monorepo) TypeScript compiler cannot find the @types directory (typeRoots misconfigured)

Is the "TS7016" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• Option 'declaration' cannot be used without 'emitDeclarationOnly' when 'noEmit' is set

  How to fix 'declaration cannot be used without emitDeclarationOnly when noEmit is set' in TypeScript

  HIGH

• Could not find a declaration file for module 'X'

  Could not find a declaration file for module 'X'

  MEDIUM

• Declaration merging failed for 'X'

  How to fix "Declaration merging failed for X" in TypeScript

  MEDIUM

• Constructor of class 'X' is not compatible with constructor signature of type 'Y'

  How to fix 'Constructor of class is not compatible with constructor signature of type' in TypeScript

  HIGH

• Cannot find name 'process'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node` and then add 'node' to the types field in your tsconfig.

  How to fix "Cannot find name 'process'" in TypeScript

  MEDIUM

• Module has no exported member 'X'

  How to fix 'Module has no exported member X' error in TypeScript

  MEDIUM

Official resources & further reading

• 📚TypeScript Official Documentation
• 📖
  TypeScript Handbook - Consuming Declaration Files(Official Docs)
• 📖
  TypeScript - Search for Type Definitions(Official Docs)
• npm - @types/lodash
• DefinitelyTyped - lodash Type Definitions
• TypeScript Center - Fix Declaration File Errors
• BobbyHadz - Could Not Find Declaration File Error
• 🐙
  lodash GitHub - Declaration File Discussion(GitHub)
• Stack Overflow - TypeScript lodash Questions