TypeScriptで.ts付きimportに出るTS5097の直し方
error TS5097: An import path can only end with a '.ts' extension when 'allowImportingTsExtensions' is enabled. は、import { add } from "./util.ts" のように、import のパスを .ts で終えたときに tsc が出すエラーです。import のパスを .js にするか、tsconfig.json に allowImportingTsExtensions か rewriteRelativeImportExtensions を足すと消えます。どれを選ぶかは、tsc で JavaScript を出力して実行するのか、.ts ファイルをそのまま実行するのかで決まります。
Node.js 22 では、22.18 から型を取り除いて実行する機能が既定で有効になり、.ts ファイルを node main.ts のように実行できます。このとき import には .ts を付ける必要があり、同じファイルを tsc で型チェックすると TS5097 が出ます。その場面を例に、3つの直し方を試しました。
検証環境は Ubuntu 24.04、Node.js 22.23.4、npm 10.9.9、TypeScript 5.9.3 です。同じエラーを TypeScript 7.0.2(検証した日の npm の latest)でも確かめました。確かめたのは tsc と node の出力だけです。TypeScript の 6.x と 5.7 より前のバージョン、VS Code などのエディターでの表示、Vite などのバンドラー、Deno や Bun、.tsx ファイルの import は試していません。
実行のしかたで直し方を選ぶ
どの直し方を選ぶかは、実行のしかたで決まります。3つの直し方をまとめると、次のようになります。
| 実行のしかた | 直し方 |
|---|---|
tsc で出力した .js を実行する |
import のパスを .js にする |
.ts をそのまま実行し、tsc は型チェックだけに使う |
allowImportingTsExtensions と noEmit を足す |
.ts をそのまま実行し、tsc で .js も出力する |
rewriteRelativeImportExtensions を足す(TypeScript 5.7 以降) |
import のパスを .ts で終えてエラーを起こす
空のフォルダーに、"type": "module" を書いた package.json を置き、TypeScript 5.9.3 を入れました。tsconfig.json は次の内容です。
{
"compilerOptions": {
"target": "es2022",
"module": "nodenext",
"strict": true,
"rootDir": "src",
"outDir": "dist"
},
"include": ["src"]
}
src/util.ts に関数を1つ書き、src/main.ts から .ts を付けたパスで import しました。
// src/util.ts
export function add(a: number, b: number): number {
return a + b;
}
// src/main.ts
import { add } from "./util.ts";
console.log(add(1, 2));
npx tsc を実行すると、次のエラーが出て、終了コードは 2 でした。
$ npx tsc
src/main.ts(1,21): error TS5097: An import path can only end with a '.ts' extension when 'allowImportingTsExtensions' is enabled.
メッセージは「import のパスを .ts で終えてよいのは、allowImportingTsExtensions が有効なときだけです」という意味です。--pretty を付けると、パスの文字列 "./util.ts" の下に ~ が付きました(色は省いています)。
$ npx tsc --pretty
src/main.ts:1:21 - error TS5097: An import path can only end with a '.ts' extension when 'allowImportingTsExtensions' is enabled.
1 import { add } from "./util.ts";
~~~~~~~~~~~
Found 1 error in src/main.ts:1
このエラーが出ても、tsc は dist/main.js と dist/util.js を出力しました。ところが dist/main.js の import は "./util.ts" のままです。node dist/main.js を実行すると、dist にない util.ts を探しにいって止まり、終了コードは 1 でした(パスは /path/to/app に置き換え、スタックトレースは省いています)。
$ cat dist/main.js
import { add } from "./util.ts";
console.log(add(1, 2));
$ node dist/main.js
...
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/path/to/app/dist/util.ts' imported from /path/to/app/dist/main.js
TS5097 は、出力した JavaScript がこのように動かなくなることを知らせています。TypeScript 5.0 のリリースノートにも、.ts を付けたパスは、出力した JavaScript ファイルを実行するときには解決できない、とあります。
tsc で出力して実行するなら、パスを .js にする
src/main.ts の import を "./util.js" に変えました。src には util.js というファイルはありませんが、TypeScript は .js のパスを見ると、同じ名前の .ts ファイルを先に探します(TypeScript のモジュールのリファレンスにある、拡張子の読み替えの説明)。
import { add } from "./util.js";
console.log(add(1, 2));
npx tsc は何も出力せずに終了コード 0 になり、node dist/main.js は 3 を出力しました。
拡張子を付けずに "./util" と書くと、module が nodenext のこの設定では、別のエラーになりました。
$ npx tsc
src/main.ts(1,21): error TS2835: Relative import paths need explicit file extensions in ECMAScript imports when '--moduleResolution' is 'node16' or 'nodenext'. Did you mean './util.js'?
"module": "esnext"、"moduleResolution": "bundler"、"noEmit": true の tsconfig.json に替えると、拡張子なしの "./util" のままで npx tsc は終了コード 0 でした。ただし、この設定でも "./util.ts" に戻すと TS5097 が出ました。
.ts をそのまま実行するなら、allowImportingTsExtensions を足す
import は "./util.ts" のままにして、最初の tsconfig.json に "allowImportingTsExtensions": true だけを足すと、今度は tsconfig.json にエラーが出ました。
$ npx tsc
tsconfig.json(8,35): error TS5096: Option 'allowImportingTsExtensions' can only be used when either 'noEmit' or 'emitDeclarationOnly' is set.
TypeScript の tsconfig リファレンスにある allowImportingTsExtensions の説明には、このオプションは noEmit か emitDeclarationOnly と組み合わせたときだけ使える、とあります。5.9.3 の TS5096 の文面も同じです。JavaScript を出力しない設定にして、.ts の import の解決は、バンドラーや Node.js などのツールに任せる、という前提のオプションです。
そこで、rootDir と outDir を外して "noEmit": true を足しました。
{
"compilerOptions": {
"target": "es2022",
"module": "nodenext",
"strict": true,
"allowImportingTsExtensions": true,
"noEmit": true
},
"include": ["src"]
}
npx tsc は終了コード 0 になり、dist は作られませんでした。.ts ファイルは Node.js でそのまま実行できます。
$ node src/main.ts
3
この使い方では、import を "./util.js" に書き換える直し方は使えません。node src/main.ts は src にない util.js を探して ERR_MODULE_NOT_FOUND で止まりました。Node.js の TypeScript 対応のドキュメントにも、.ts ファイルを実行するときは import に ./file.ts のように拡張子を書く必要があり、allowImportingTsExtensions を使うと tsc でその書き方を型チェックできる、とあります。
出力もしたいなら、rewriteRelativeImportExtensions を足す
.ts ファイルをそのまま実行しつつ、配布などのために .js も出力したいときは、TypeScript 5.7 で入った rewriteRelativeImportExtensions を使います。最初の tsconfig.json に、これだけを足しました。
{
"compilerOptions": {
"target": "es2022",
"module": "nodenext",
"strict": true,
"rootDir": "src",
"outDir": "dist",
"rewriteRelativeImportExtensions": true
},
"include": ["src"]
}
"./util.ts" のままで npx tsc は終了コード 0 になり、出力された dist/main.js の import は .js に書き換わっていました。
$ cat dist/main.js
import { add } from "./util.js";
console.log(add(1, 2));
node dist/main.js も node src/main.ts も、どちらも 3 を出力しました。allowImportingTsExtensions も一緒に足しても、終了コードは 0 でした。5.9.3 の TS5096 の文面にも tsconfig リファレンスにも、この組み合わせは書かれていませんが、rewriteRelativeImportExtensions と一緒なら、noEmit がなくても allowImportingTsExtensions を使えました。
TypeScript 5.7 のリリースノートによると、書き換わるのは ./ か ../ で始まる相対パスで、.ts、.tsx、.mts、.cts で終わるものだけです。パッケージ名で始まるパスや、tsconfig.json の paths を使ったパスは書き換わりません。
TypeScript 7.0.2 でも同じメッセージが出る
TypeScript 7.0.2 でも、同じ src/main.ts で TS5097 が出ました。メッセージは 5.9.3 と一字一句同じで、終了コードも 2 でした。
$ npx tsc
src/main.ts(1,21): error TS5097: An import path can only end with a '.ts' extension when 'allowImportingTsExtensions' is enabled.
noEmit なしで allowImportingTsExtensions を足したときの TS5096 は、文面が変わり、使える組み合わせに rewriteRelativeImportExtensions が加わっていました。
$ npx tsc
tsconfig.json(8,35): error TS5096: Option 'allowImportingTsExtensions' can only be used when one of 'noEmit', 'emitDeclarationOnly', or 'rewriteRelativeImportExtensions' is set.
allowImportingTsExtensions と noEmit を足した設定と、rewriteRelativeImportExtensions を足した設定は、7.0.2 でもどちらも終了コード 0 でした。rewriteRelativeImportExtensions で出力された dist/main.js の import は、5.9.3 と同じく .js になっていました。この記事の tsconfig.json に "rootDir": "src" を書いているのは、7.0.2 では rootDir がないと、TS5097 は出ずに、rootDir の指定を求める TS5011 で止まったためです。




