できない.dev

TypeScript「Option 'baseUrl' has been removed」の原因と直し方

Option 'baseUrl' has been removed は、TypeScript 7.0 で消えた指定が tsconfig にあると出る。
6.0 で非推奨になった指定で、ignoreDeprecations では黙らせられない。
指定を消すか今の書き方に直せば通る。

公開:

症状できない · exit 1
npx tsc -p .
tsconfig.json(5,25): error TS5108: Option 'moduleResolution=node10' has been removed. Please remove it from your configuration.
tsconfig.json(6,5): error TS5102: Option 'baseUrl' has been removed. Please remove it from your configuration.
  Use '"paths": {"*": ["./*"]}' instead.
tsconfig.json(7,24): error TS5090: Non-relative paths are not allowed. Did you forget a leading './'?
解決後できた · exit 0
npx tsc -p .

2026-11-06 に node:24(TypeScript 7.0.2 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

error TS5102: Option 'baseUrl' has been removed. Please remove it from your configuration. は、TypeScript 7.0 で消えた指定が tsconfig.json に残っているときに出るエラーだ。
値ごと消えた指定は、TS5108: Option 'moduleResolution=node10' has been removed. のように指定と値の組で出る。
どちらも 6.0 で非推奨になった指定で、6.0 の間は "ignoreDeprecations": "6.0" で黙らせられた。
7.0 にこの逃げ道は無く、指定を書き直すまで tsc は止まる。

6.0 では、同じ指定が TS5101: Option 'baseUrl' is deprecated and will stop functioning in TypeScript 7.0. と TS5107 で出る。
番号は違うが、直し方は 7.0 と同じである。

実行例

node:24 のコンテナで、同じ tsconfig.json を TypeScript 7.0.2 と 6.0.3 の tsc にかけた。
7.0.2 では ignoreDeprecations を足しても 3 つのエラーが残り、baseUrl を消して paths と moduleResolution を書き直すと終了コードが 0 になった。

$ npx tsc -v
Version 7.0.2
$ cat tsconfig.json
{
  "compilerOptions": {
    "noEmit": true,
    "module": "commonjs",
    "moduleResolution": "node",
    "baseUrl": ".",
    "paths": { "@/*": ["src/*"] }
  },
  "include": ["src"]
}
$ npx tsc -p .
tsconfig.json(5,25): error TS5108: Option 'moduleResolution=node10' has been removed. Please remove it from your configuration.
tsconfig.json(6,5): error TS5102: Option 'baseUrl' has been removed. Please remove it from your configuration.
  Use '"paths": {"*": ["./*"]}' instead.
tsconfig.json(7,24): error TS5090: Non-relative paths are not allowed. Did you forget a leading './'?
$ echo $?
1
$ npx tsc -v
Version 6.0.3
$ npx tsc -p .
tsconfig.json(5,25): error TS5107: Option 'moduleResolution=node10' is deprecated and will stop functioning in TypeScript 7.0. Specify compilerOption '"ignoreDeprecations": "6.0"' to silence this error.
  Visit https://aka.ms/ts6 for migration information.
tsconfig.json(6,5): error TS5101: Option 'baseUrl' is deprecated and will stop functioning in TypeScript 7.0. Specify compilerOption '"ignoreDeprecations": "6.0"' to silence this error.
  Visit https://aka.ms/ts6 for migration information.
$ echo $?
2
$ npx tsc -p .
tsconfig.json(5,25): error TS5108: Option 'moduleResolution=node10' has been removed. Please remove it from your configuration.
tsconfig.json(6,5): error TS5102: Option 'baseUrl' has been removed. Please remove it from your configuration.
  Use '"paths": {"*": ["./*"]}' instead.
tsconfig.json(7,24): error TS5090: Non-relative paths are not allowed. Did you forget a leading './'?
$ echo $?
1
$ cat tsconfig.json
{
  "compilerOptions": {
    "noEmit": true,
    "module": "commonjs",
    "moduleResolution": "bundler",
    "paths": { "@/*": ["./src/*"] }
  },
  "include": ["src"]
}
$ npx tsc -p .
$ echo $?
0

— 2026-11-06 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-06 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • TypeScript 7.0.2

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

解決策

1. baseUrl を消して paths を ./ 始まりにする

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

paths は baseUrl が無くても書け、そのときは tsconfig.json の場所が起点になる。
7.0 のエラーに添えられる "paths": {"*": ["./*"]} は、baseUrl で解決していたすべてのパスを残す書き方だ。
@/* のような別名だけを使っていたなら、別名の行を書き直せば足りる。

2. moduleResolution: node を替える

Vite や webpack でまとめるプロジェクトは "moduleResolution": "bundler" にする。
拡張子を省いた import も今までどおり解決される。
Node.js で直接動かすプロジェクトは "module": "nodenext" にすると、moduleResolution も nodenext になる。
"type": "module" の ESM では相対パスの import に .js が要る(NodeNext の拡張子の記事)。

3. ほかの消えた指定を直す

7.0.2 で試した範囲では、次の指定も同じ形のエラーになった。

tsconfig の指定7.0 のエラー直し方
"target": "es5"TS5108es2015 以上にする。ES5 が要るなら出力を Babel や SWC で変換する
"downlevelIteration": trueTS5102消す
"module": "amd"TS5108esnext などにし、まとめるのはバンドラーに任せる
"esModuleInterop": falseTS5108消す(esModuleInterop の記事)
"alwaysStrict": falseTS5108消す。予約語を変数名にしている箇所は名前を変える

全部を直したら、ignoreDeprecations の行も消す。

4. 7.0 に上げる前に 6.0 で洗い出す

6.0 のうちに tsconfig から ignoreDeprecations を外し、npx tsc -p . を打つ。
TS5101 / TS5107 で出た指定が、7.0 で止まる指定と同じになる(TypeScript 7.0 の告知(新しいタブで開く))。

よくある原因

  1. 6.0 で非推奨になった指定を残したまま 7.0 に上げた。
    "baseUrl": "." や "moduleResolution": "node" は、古いテンプレートから作った tsconfig によく入っている。
  2. 6.0 の TS5101 / TS5107 を "ignoreDeprecations": "6.0" で黙らせていた。
    7.0 は ignoreDeprecations を書いてもエラーにしないが、消えた指定のエラーも消さない。
  3. baseUrl を消したあとの paths が src/* のように書かれている。
    baseUrl が無いと paths の行き先は ./ で始まる相対パスでなければならず、TS5090: Non-relative paths are not allowed. になる。