できない.dev

TypeScript「Parameter implicitly has an 'any' type」の原因と直し方

Parameter implicitly has an 'any' type は、引数に型注釈を付ければ消える。
noImplicitAny が有効で型を推論できない引数に出る。
コールバックは文脈から型が付くように書く。

公開: 更新:

症状できない · exit 2
npx tsc
src/bad.ts(1,16): error TS7006: Parameter 'name' implicitly has an 'any' type.
解決後できた · exit 0
npx tsc

2026-10-27 に node:20(TypeScript 5.9.3 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

Parameter 'x' implicitly has an 'any' type.(TS7006)は、noImplicitAny(strict 配下)が有効なときに、引数の型が注釈も推論もできず暗黙の any になっていることを示す。
原則は引数へ明示的な型を付けることで、コールバックは推論が効く書き方に直すと解消する。

実行例

node:20 環境で上記の手順を動かすと、型注釈のない引数 name に対して error TS7006: Parameter 'name' implicitly has an 'any' type.(終了コード 2)が出た。
解消策 1・2 のどちらを適用しても、終了コード 0 でコンパイルが完了した。

v20.20.2
Version 5.9.3
$ npx tsc
src/bad.ts(1,16): error TS7006: Parameter 'name' implicitly has an 'any' type.
$ echo $?
2
$ npx tsc
$ echo $?
0
$ npx tsc
$ echo $?
0

— 2026-10-27 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-27 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • TypeScript 5.9.3

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 引数に型注釈を付ける

最も素直な解決策だ。

function greet(name: string): string {
  return `Hello, ${name}`;
}

利用できる型注釈は公式ハンドブック(新しいタブで開く)にまとまっている。

2. 文脈的型付けを効かせる

コールバックは「型の付いた関数の引数」として渡せば推論される。

const nums = [1, 2, 3];
nums.map((n) => n * 2); // n は number と推論される

map の型から n: number が文脈的に決まるため、注釈は不要になる。

3. 設定で段階移行する(暫定)

大量の既存コードを一度に直せない場合のみ、tsconfig.json で一時的に緩める。

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

ただし型安全性が下がるので、恒久策にはしない。
noImplicitAny の意味を公式の tsconfig リファレンス(新しいタブで開く)で確かめながら、段階的に型を付けて戻す。

よくある原因

  1. noImplicitAny が有効になっている。
    strict: true を入れると noImplicitAny も有効になり、注釈の無い引数がエラーになる。
  2. 関数を独立して宣言している。
    function f(x) {} のように単独で定義した関数には、呼び出し側から型が伝播しない。
  3. 型のない JS と連携している。
    @types の無いライブラリのコールバック引数は推論材料が無く、any になる。