03.1 tsconfig.json は3つのことを決める

設定項目は多いが、決めていることは少ない

tsc --init が生成する tsconfig.json には数十の項目が並びます。しかし決めていることは大きく3つです。

最小の設定

Node で動かす前提なら、まずこれで足ります。

{
	"compilerOptions": {
		"target": "es2022",
		"module": "nodenext",
		"moduleResolution": "nodenext",
		"strict": true,
		"types": ["node"],
		"outDir": "dist"
	},
	"include": ["src/**/*.ts"]
}

include と exclude

「特定のファイルだけ型が付かない」ときは、まず include から漏れていないかを見ます。

03.2 strict — 何を防いでいるか

TypeScript 7 では既定で有効になった

TS7 TypeScript 7 は strict が既定で true です。5 系は既定で false でした。

// strict-test.ts
function greet(name) {
	return "Hello, " + name.toUpperCase();
}
const u: { name?: string } = {};
console.log(u.name.length);

strict が有効にする主な項目

実際のエラー

$ npx tsc --noEmit
strict-test.ts(1,16): error TS7006: Parameter 'name' implicitly has an 'any' type.
strict-test.ts(5,13): error TS18048: 'u.name' is possibly 'undefined'.

訳: 引数 'name' は暗黙的に 'any' 型になっています。
    'u.name' は 'undefined' の可能性があります。

個別に切る場合

strict: true のまま、特定の項目だけ切ることもできます。順序が重要で、strict の後に書いた項目が勝ちます。

{
	"compilerOptions": {
		"strict": true,
		"strictPropertyInitialization": false   // ← strict の後なのでこちらが有効
	}
}

let s: string = null;         // エラー TS2322
let t: string | null = null;  // これなら通る

03.3 target と lib — どの JavaScript を出すか

target — 出力する構文のレベル

target は出力する JavaScript の文法レベルを決めます。古い値にすると、新しい構文が古い書き方に変換されます。

Node で動かすなら es2022 以上で構いません。古い値にする理由は、古いブラウザを相手にする場合だけです。

lib — 使える標準 API

lib は型として存在する標準 APIを決めます。target から自動で決まるため、通常は書きません。

03.4 module と moduleResolution — import の解決

2つは役割が違う

Node 向けなら nodenext

ESMCJS Node で動かすなら、両方 nodenext にするのが確実です。package.json の "type" を見て、ESM と CJS を自動で切り替えます。

{
	"compilerOptions": {
		"module": "nodenext",
		"moduleResolution": "nodenext"
	}
}

paths は実行時には効かない

paths でインポートの別名を作れますが、これは型検査だけの機能です。

{
	"compilerOptions": {
		"baseUrl": ".",
		"paths": { "@/*": ["src/*"] }
	}
}

import { greet } from "@/greet";   // tsc は解決できる
                                   // node は解決できない

設定が合っているかの確かめ方

$ npx tsc --showConfig      # 実際に使われる設定を展開して表示する

継承（extends）や既定値を含めた最終的な設定が出ます。「書いたはずの設定が効かない」ときは、これで実際の値を確認します。