TypeScript 10 tsconfig・strict・実行環境・バージョン

更新日: 2026-09-29

tsconfig.json とは

プロジェクトの TypeScript 設定。どのファイルを対象にし、どれだけ厳しくチェックし、どう出力するかを決める。npx tsc --init で作成。フレームワークのテンプレートでは作成済み。

実務の推奨設定(フレームワーク利用・バンドラーあり)

{
  "compilerOptions": {
    // 出力・モジュール
    "target": "es2025",
    "module": "esnext",
    "moduleResolution": "bundler",     // Vite / Next.js / TanStack Start 向け
    "lib": ["es2025", "dom"],
    "jsx": "react-jsx",
    "noEmit": true,                    // 変換はバンドラーがする。tsc は型チェックだけ
    "verbatimModuleSyntax": true,      // 型の import に `import type` を強制
    "isolatedModules": true,           // ファイル単位変換ツールとの互換
    "resolveJsonModule": true,
    "skipLibCheck": true,              // node_modules 内の .d.ts のチェックを省略(高速化)
 
    // 厳しさ
    "strict": true,
    "noUncheckedIndexedAccess": true,  // arr[i] を T | undefined に
    "exactOptionalPropertyTypes": true,// a?: string に undefined を明示代入させない(厳しめ・任意)
    "noImplicitOverride": true,
    "noFallthroughCasesInSwitch": true,
 
    // 型定義・パス
    "types": ["node"],                 // TS 6 から既定は []。必要なものを明示
    "paths": { "@/*": ["./src/*"] }
  },
  "include": ["src"]
}

Node.js 向け(バンドラーなし)なら "module": "nodenext"(moduleResolution も自動で nodenext)。

strict に含まれるもの

"strict": true は以下をまとめて有効にする(TS 6 から既定で true)。

主要オプション早見表

リファレンス: https://www.typescriptlang.org/tsconfig/

実行環境の選び方

バージョンの歴史と現在(2026年9月時点)

TS 6.0 の変更(7.0 も同じ既定値)

• 新しい既定値: strict: true / module: esnext / target: es2025 / types: [] / rootDir は tsconfig のあるフォルダ
• 非推奨(7 で削除): target: es5、moduleResolution: node(node10)、AMD / UMD / SystemJS、baseUrl、outFile
• 移行の一時しのぎ: "ignoreDeprecations": "6.0"
• 新機能: #/ で始まるサブパス import、Temporal の型、Map.getOrInsert、RegExp.escape、dom lib に iterable 系を統合
• よくある移行作業: types に ["node"] などを追加 / baseUrl をやめて paths を相対指定に / moduleResolution を bundler か nodenext へ

TS 7.0(Go 製ネイティブ版)

• 大規模プロジェクトの型チェックが約10倍高速(例: VS Code のコードベース 125.7秒 → 10.6秒)、メモリも削減
• 入れ方は従来通り npm install -D typescript → npx tsc
• エディタ: VS Code は専用拡張で新しい言語サービスを使う
• ⚠️ まだ安定したプログラム API(TS をライブラリとして呼ぶ機能)が無く、Vue / Svelte / Astro など一部ツールは対応待ち(7.1 で対応予定)。困ったら 6.0 を併用
• 6.0 で非推奨の警告が出ない状態にしておけば、7.0 への移行はスムーズ

関連

• 前: TypeScript_09_型システムの性質(構造的型付け・推論・satisfies) / 次: TypeScript_11_実務パターン・よくあるエラー・AI開発
• 出典: https://www.typescriptlang.org/tsconfig/ , https://devblogs.microsoft.com/typescript/announcing-typescript-6-0/ , https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/