できない.dev

TypeScript「TS5112: tsconfig.json is present」の原因と直し方

TS5112: tsconfig.json is present は、tsc にファイルを渡さず打つか、--ignoreConfig を付ければ直る。
TypeScript 6.0 から、tsconfig.json のある場所で tsc index.ts と打つとエラーになった。

公開:

要約

TypeScript 6.0 で、tsconfig.json のあるディレクトリに npx tsc index.ts を打つと、何も出力せずに終了コード 1 で止まる。

error TS5112: tsconfig.json is present but will not be loaded if files are specified on commandline. Use '--ignoreConfig' to skip this error.

5.x は、ファイルを渡された tsc は tsconfig.json を読まずに、そのファイルだけを既定の設定で変換していた。
tsconfig.json に書いた設定が効かないまま出力が作られるので、TypeScript 6.0 からは TS5112 で止めてどちらの意図かを明示させる。
tsconfig.json の設定で変換するならファイルを渡さず tsc を打ち、無視するなら --ignoreConfig を付ければ直る。

解決策

1. tsconfig.json の設定で変換する

tsconfig.json に書いた設定を効かせたいなら、ファイルを渡さずに打つ。
こうすると、tsconfig.json の include や files に書いたファイルが、書いた設定で変換される。

npx tsc

tsc --init が作る tsconfig.json のままなら、index.js に加えて index.d.ts と、index.js.map・index.d.ts.map も出力される。
5.x で tsc index.ts を打っていたときには出なかったファイルである。

2. tsconfig.json を無視して 1 ファイルだけ変換する

エラーの文言のとおり --ignoreConfig を付ける。
TypeScript 6.0 の発表(新しいタブで開く)は、tsconfig.json を無視して既定値で変換したいときに使う新しいフラグとして紹介している。

npx tsc --ignoreConfig index.ts

このとき使われるのは 6.0 の既定値である。
export の無いファイルでは、5.x では var に変わっていた const がそのまま残り、先頭に "use strict"; が付いた。
export のあるファイルは ESM のまま出力される。
6.0 の既定は strict: true なので、5.x では出なかった型エラーが出ることもある。

3. scripts と CI を検索して書き替える

grep -rnE "tsc [^-]" package.json .github/

見つかった呼び出しを、tsconfig.json を使うなら tsc か tsc -p tsconfig.json に、使わないなら tsc --ignoreConfig ファイル名 に書き替える。

よくある原因

  1. TypeScript を 6.0 に上げた。
    5.9 で tsc --init のあとに tsc index.ts を打つと、終了コード 0 で index.js が作られていた。
    6.0 では同じ手順で TS5112 になり、index.js は作られない。
  2. package.json の scripts や CI のジョブに、ファイル名を渡す tsc の呼び出しが残っている。
    手元で打たなくても、npm run build や CI が上げた直後に止まる。
  3. tsc --init で tsconfig.json を作ったあと、ファイルを渡す形の手順をそのまま打った。
    tsconfig.json が置かれた時点で、このエラーの条件がそろう。