TypeScriptで型のないパッケージに出るTS7016の直し方
error TS7016: Could not find a declaration file for module 'lodash-es'. は、import した npm パッケージに型の宣言ファイル(.d.ts)が見つからないときに出ます。パッケージ自体は入っていて、実行もできます。@types/パッケージ名 を入れるか、自分で declare module を書いた宣言ファイルを置くと、エラーは消えます。
npm で入れたライブラリを TypeScript のコードで import したら、型チェック(tsc)でこのエラーが出た、エディターで import の行に赤い波線が出た、というときの原因と直し方です。私は検証環境でこのエラーを起こし、メッセージをそのまま載せました。直したあとにエラーが消えることも、tsc とエディター用の言語サーバーの両方で確かめています。
検証環境は Ubuntu 24.04、Node.js 22.23.4、npm 10.9.9、TypeScript 7.0.2 です。型の付いていないパッケージの例として lodash-es 4.18.1 を使いました。エディターの表示は、VS Code などのエディター本体ではなく、エディターが診断に使う TypeScript の言語サーバー(tsc --lsp --stdio)を直接動かして確かめています。VS Code の画面での見え方、Vite などのバンドラーを通したビルド、TypeScript 7 より前のバージョンは試していません。
エラーを起こしたコードとメッセージ
空のフォルダーで npm init -y を実行し、package.json に "type": "module" を足しました。TypeScript 7.0.2 と lodash-es 4.18.1 を入れ、npx tsc --init で tsconfig.json を作っています。できた tsconfig.json には "strict": true が入っていました。
lodash-es のフォルダーには .d.ts のファイルがなく、package.json にも types の項目はありません。node_modules/@types のフォルダーもない状態です。
次の src/index.ts で、lodash-es の debounce を読み込みました。
import { debounce } from "lodash-es";
const save = debounce((text: string) => {
console.log(`saved: ${text}`);
}, 300);
save("hello");
npx tsc --noEmit を実行すると、次の2行が出て、終了コードは 1 でした(検証では出力をファイルに残しています)。/path/to/app はプロジェクトの場所で、実際の出力にあった検証環境のパスを置き換えています(以下も同じです)。
$ npx tsc --noEmit
src/index.ts(1,26): error TS7016: Could not find a declaration file for module 'lodash-es'. '/path/to/app/node_modules/lodash-es/lodash.js' implicitly has an 'any' type.
Try `npm i --save-dev @types/lodash-es` if it exists or add a new declaration (.d.ts) file containing `declare module 'lodash-es';`
--pretty を付けると、該当するコードの行が表示され、"lodash-es" の部分に波線が付きます(色は省いています)。
src/index.ts:1:26 - error TS7016: Could not find a declaration file for module 'lodash-es'. '/path/to/app/node_modules/lodash-es/lodash.js' implicitly has an 'any' type.
Try `npm i --save-dev @types/lodash-es` if it exists or add a new declaration (.d.ts) file containing `declare module 'lodash-es';`
1 import { debounce } from "lodash-es";
~~~~~~~~~~~
Found 1 error in src/index.ts:1
1行目の意味は「lodash-es の宣言ファイルが見つからない。node_modules/lodash-es/lodash.js は暗黙に any 型になる」です。TypeScript は JavaScript の本体(lodash.js)までは見つけていて、型の情報だけがありません。2行目は直し方の案内で、「@types/lodash-es があれば入れるか、declare module 'lodash-es'; を書いた .d.ts ファイルを足す」と書かれています。
型チェックでエラーになっても、プログラムは動きます。Node.js 22.23.4 で node src/index.ts を実行すると、saved: hello と表示されて終了コード 0 でした(Node.js のドキュメントによると、v22.18.0 から .ts の型の部分を取り除いて実行する機能が既定で有効です)。
エディターでは、import の行がエラーになり、値は any になる
エディターが使う言語サーバーにも、同じファイルを開かせました。返ってきた診断は1件で、tsc と同じ文面です。
diagnostics (1):
1:26-1:37 severity=1 source=ts code=7016 Could not find a declaration file for module 'lodash-es'. '/path/to/app/node_modules/lodash-es/lodash.js' implicitly has an 'any' type.
Try `npm i --save-dev @types/lodash-es` if it exists or add a new declaration (.d.ts) file containing `declare module 'lodash-es';`
hover 3:7: const save: any
1:26-1:37 は1行目の "lodash-es"(引用符を含む)の範囲で、エディターではここに赤い波線が出ます。severity=1 は、Language Server Protocol の仕様でエラーを表す値です。3行目の save にカーソルを合わせたときの表示(ホバー)は const save: any で、debounce が返した値にも型がありません。
noImplicitAny を切ると、エラーは出ないが型もない
このエラーは、tsconfig.json の noImplicitAny から出ています。この設定は strict: true にすると一緒に有効になり、TypeScript が型を推論できずに any にするところをエラーにします。
確かめるため、文字列を受け取る関数に、わざと数値を渡す src/typo.ts を足しました。
import { debounce } from "lodash-es";
const count = debounce((text: string) => text.length, 300);
count(123);
npx tsc --noEmit --noImplicitAny false で実行すると、何も出力されずに終了コード 0 で終わりました。TS7016 が消えただけでなく、count(123) の間違いも見つかりません。言語サーバーにはコマンドの指定を渡せないので、tsconfig.json に "noImplicitAny": false を書いてから開かせました。TS7016 の診断は severity=4(LSP の仕様ではヒント)で返り、save のホバーは const save: any のままでした。
noImplicitAny を切ると、エラーの表示は消えても、パッケージの型がないことは変わりません。直すときは、次の節のように型の情報を足します。
@types のパッケージを入れる
パッケージによっては、型の宣言だけを収めたパッケージが、別に npm で公開されています。TypeScript ハンドブックにある、宣言ファイルの入手方法の説明によると、名前はたいてい元のパッケージ名の前に @types/ を付けたものです。lodash なら npm install --save-dev @types/lodash で宣言が手に入る、とも書かれています。
あるかどうかは、npm view で確かめられます。
$ npm view @types/lodash-es version
4.17.12
ない名前を指定すると、npm error code E404 で終わります。
npm install -D @types/lodash-es@4.17.12 で、開発用の依存として入れました。package.json の devDependencies は次のようになります。
"devDependencies": {
"@types/lodash-es": "^4.17.12",
"typescript": "^7.0.2"
},
これで npx tsc --noEmit を実行すると、何も出力されずに終了コード 0 で終わりました。言語サーバーの診断も 0 件になり、save のホバーは const save: DebouncedFunc<(text: string) => void> に変わりました。
src/typo.ts をもう一度置いて実行すると、今度は間違いが見つかります。
$ npx tsc --noEmit
src/typo.ts(4,7): error TS2345: Argument of type 'number' is not assignable to parameter of type 'string'.
なお、tsc --init で作った tsconfig.json には "types": [] が入っていますが、そのままでかまいません。types の説明によると、この設定が決めるのは、import しなくても読み込まれる型(Node.js の process などのグローバルな型)だけです。import したパッケージの @types は、この設定に関係なく使われます。検証でも、"types": [] のままでエラーは消えました。
@types がないなら、declare module を書く
@types が公開されていないパッケージでは、自分で宣言ファイルを書きます。方法は2つあります。
1行だけ書いて、エラーを消す
エラーメッセージの案内どおり、src/lodash-es.d.ts に次の1行を書きました。
declare module "lodash-es";
npx tsc --noEmit は、出力なしで終了コード 0 になりました。言語サーバーの診断も 0 件です。
ただし、save のホバーは const save: any のままでした。中身を書かない declare module(shorthand ambient module declaration)について、TypeScript 2.0 のリリースノートには「このモジュールからの import は、すべて any 型になる」とあります。検証でも、src/typo.ts を置いて npx tsc --noEmit を実行すると、終了コード 0 で終わりました。エラーを消すことはできますが、型チェックはされません。
使う関数だけ型を書く
パッケージ全体の型を書く必要はありません。使っている関数だけ書けば、その部分は型チェックされます。src/lodash-es.d.ts を次のように書き換えました。
declare module "lodash-es" {
export function debounce<Args extends unknown[]>(
func: (...args: Args) => unknown,
wait?: number,
): (...args: Args) => void;
}
npx tsc --noEmit は終了コード 0 で、save のホバーは const save: (text: string) => void になりました。src/typo.ts を足すと、@types を入れたときと同じ TS2345 のエラーが出ました。
この宣言に書いていない関数を import すると、型のエラーになります。import { throttle } from "lodash-es" を足すと、次のエラーが出ました。使う関数が増えたら、宣言にも足していきます。
src/throttle.ts(1,10): error TS2305: Module '"lodash-es"' has no exported member 'throttle'.
もう1つ、宣言ファイルの一番外側に import や export を書かないようにします。検証では、src/lodash-es.d.ts の先頭に export {}; の1行を足すと、TS7016 がまた出ました。TypeScript のドキュメントにある ambient module の説明によると、一番外側に import か export があるファイルでは、declare module は新しいモジュールの宣言ではなく、既にあるモジュールに型を足す書き方(module augmentation)として扱われます。
パッケージを入れていないときは TS2307 になる
TS7016 は、パッケージは見つかったが型がない、というエラーです。パッケージそのものが見つからないときは、別の番号になります。node_modules にない lodash-es-not-installed を import すると、次のメッセージでした。
src/missing.ts(1,26): error TS2307: Cannot find module 'lodash-es-not-installed' or its corresponding type declarations.
TS2307 が出ているなら、まずパッケージ名の書き間違いや、npm install のし忘れを疑います。
「There are types at …」と続くときは、パッケージ側の設定の問題
TS7016 のメッセージの2行目が、Try npm i ... ではなく次のようになることがあります。検証用に作ったローカルのパッケージ demo-pkg で起こしました。
src/demo.ts(1,23): error TS7016: Could not find a declaration file for module 'demo-pkg'. '/path/to/demo-pkg/dist/index.js' implicitly has an 'any' type.
There are types at '/path/to/demo-pkg/types/index.d.ts', but this result could not be resolved when respecting package.json "exports". The 'demo-pkg' library may need to update its package.json or typings.
/path/to/demo-pkg は demo-pkg を置いた場所です。同じ実行では lodash-es の TS7016 も出ていましたが、ここでは省いています。
「型は types/index.d.ts にあるが、package.json の exports に従うと見つけられない。パッケージの package.json か型の設定を直す必要があるかもしれない」という意味です。demo-pkg の package.json は、次のようにしていました。
{
"name": "demo-pkg",
"version": "1.0.0",
"type": "module",
"types": "./types/index.d.ts",
"exports": {
".": "./dist/index.js"
}
}
TypeScript のモジュール解決の説明によると、moduleResolution が node16、nodenext、bundler のときは exports に従ってファイルを探します。一番上の types が読まれるのは、exports を読まないときだけです。tsc --init の tsconfig.json は "module": "nodenext" で、この設定にすると moduleResolution も nodenext になるため、exports が使われました。
パッケージの exports に types の条件を足すと、demo-pkg の TS7016 は消えました。
{
"name": "demo-pkg",
"version": "1.0.0",
"type": "module",
"types": "./types/index.d.ts",
"exports": {
".": {
"types": "./types/index.d.ts",
"default": "./dist/index.js"
}
}
}
これはパッケージを作る側の直し方です。使う側では、前の節と同じように宣言ファイルを書いて対処できます。パッケージの package.json を直す前の状態で、次の src/demo-pkg.d.ts を置くと、demo-pkg の TS7016 は出なくなりました。
declare module "demo-pkg" {
export function greet(name: string): string;
}




