ViteのFailed to resolve importの直し方
Vite の開発サーバーで Failed to resolve import "./Foo" from "src/App.tsx". Does the file exist? と出るのは、src/App.tsx の import に書いた ./Foo というファイルが見つからないためです。ファイル名の大文字・小文字か、import のパス(フォルダーの位置)を実際のファイルに合わせれば、エラーは消えます。
npm run dev で React のアプリを開いたら、ブラウザーの画面に黒っぽい枠のエラー表示が重なり、ターミナルにもエラーが出た、というときに見る原因と直し方です。私は検証環境でこのエラーを2通りの間違いで起こし、ブラウザーとターミナルに出たメッセージをそのまま載せました。どちらも、直すとエラーが消えることまで確かめています。
検証環境は Ubuntu 24.04(ファイルシステムは ext4)、Node.js 22.23.4、Vite 8.3.8、@vitejs/plugin-react 6.3.0、React 19.3.1、TypeScript 7.0.2 です。プロジェクトは npm create vite@latest の react-ts テンプレートで作りました。ブラウザーは Playwright 1.63.0 の Chromium で開いています。Windows と macOS では試していません。
ファイル名の大文字・小文字が違うと出るメッセージ
1つ目は、ファイル名を小文字の foo.tsx にしたまま、App.tsx では大文字の ./Foo を読み込む間違いです。
// src/App.tsx
import Foo from './Foo'
function App() {
return (
<main>
<h1>App</h1>
<Foo />
</main>
)
}
export default App
// src/foo.tsx
function Foo() {
return <p>Foo を読み込めました</p>
}
export default Foo
npx vite で開発サーバーを動かしてブラウザーで開くと、ページの本文は空のままで、次のエラー表示が重なりました。

表示されていた文字は次のとおりです(スタックトレースの at の行は略しました)。
[plugin:vite:import-analysis] Failed to resolve import "./Foo" from "src/App.tsx". Does the file exist?
/path/to/app/src/App.tsx:1:16
1 | import Foo from "./Foo";
| ^
2 | var _jsxFileName = "/path/to/app/src/App.tsx";
3 | import { jsxDEV as _jsxDEV } from "react/jsx-dev-runtime";
Click outside, press Esc key, or fix the code to dismiss.
You can also disable this overlay by setting server.hmr.overlay to false in vite.config.ts.
開発サーバーを動かしているターミナルには、同じ内容が Internal server error として出ました(スタックトレースの at の行は略しました)。
6:45:04 PM [vite] Internal server error: Failed to resolve import "./Foo" from "src/App.tsx". Does the file exist?
Plugin: vite:import-analysis
File: /path/to/app/src/App.tsx:1:16
1 | import Foo from "./Foo";
| ^
2 | var _jsxFileName = "/path/to/app/src/App.tsx";
3 | import { jsxDEV as _jsxDEV } from "react/jsx-dev-runtime";
続けて、同じ中身の (client) Pre-transform error: Failed to resolve import "./Foo" from "src/App.tsx". Does the file exist? が何回か出ました。回数は起動のたびに違いましたが、中身はどれも同じです。
検証では、プロジェクトを /path/to/app というフォルダーに置いて動かしたので、パスはそのまま載せています。
メッセージのどこを見ればよいか
Failed to resolve import "./Foo" の "./Foo" が、import に書いた文字列です。from "src/App.tsx" は、その import を書いたファイルです。Vite 8.3.8 のコードでは、このファイルの位置を、開発サーバーを起動したフォルダーからの相対パスで出しています。
1:16 は、1行目にある "./Foo" の位置を指しています(列を0から数えた値で、あとで出てくる vite build のメッセージでは、同じ位置が 1:17 と出ます)。その下に並ぶ2行目と3行目は、Vite が変換したあとのコードで、自分で書いた App.tsx の2行目(空行)とは違います。見るのは1行目だけで足ります。
./Foo のように拡張子を書かないと、Vite は .mjs、.js、.mts、.ts、.jsx、.tsx、.json を付けて探します(公式ドキュメントの resolve.extensions の項目)。このエラーは、src/Foo.tsx を含めて、どれも見つからなかったという意味です。検証環境の Linux(ext4)では、ファイル名の大文字・小文字を区別するので、foo.tsx があっても ./Foo には当たりません。
ファイル名を import に合わせると、すぐに消える
ブラウザーのページを開いたまま、ファイル名を import に合わせて Foo.tsx に変えました。
$ mv src/foo.tsx src/Foo.tsx
ターミナルに [vite] (client) page reload src/Foo.tsx と出て、ブラウザーのページが自動で読み込み直され、エラー表示が消えました。ページには次のように表示されています。

開発サーバーを止めて起動し直してから開いても、エラーは出ませんでした。
Vite のトラブルシューティングには、大文字・小文字を区別しないファイルシステム(Windows、macOS)で作ったプロジェクトを、区別するファイルシステム(Linux)でビルドすると、Module not found などのエラーになることがある、と書かれています。import の大文字・小文字は、ファイル名と正確に合わせておきます。
フォルダーの位置を書き間違えたときも、同じメッセージになる
2つ目は、ファイルを src/components/Foo.tsx に置いたのに、App.tsx では './Foo' のまま読み込む間違いです。ファイルを移したあとの ls の結果は次のとおりです。
$ ls src src/components
src:
App.tsx
components
index.css
main.tsx
src/components:
Foo.tsx
開発サーバーで開くと、ブラウザーとターミナルには、大文字・小文字の間違いのときと一字一句同じメッセージが出ました(ターミナルの時刻を除きます)。メッセージだけでは、名前の違いなのか位置の違いなのかは分かりません。import を書いたファイル(src/App.tsx)から見て、./Foo が指す場所に、その名前のファイルが本当にあるかを確かめます。
App.tsx の1行目を、ファイルの位置に合わせて直しました。
import Foo from './components/Foo'
保存すると、ターミナルに [vite] (client) page reload src/App.tsx と出て、ブラウザーのエラー表示が消え、「Foo を読み込めました」が表示されました。
ビルドでは、メッセージが変わる
react-ts テンプレートの npm run build は、tsc -b && vite build を実行します。同じ間違いのまま実行すると、先に動く TypeScript のコンパイラー(tsc)が止まり、Vite のビルドまで進みませんでした(終了コードは 1)。
$ npm run build
> app@0.0.0 build
> tsc -b && vite build
src/App.tsx(1,17): error TS2307: Cannot find module './Foo' or its corresponding type declarations.
vite build だけを実行した場合は、Vite 8.3.8 では次のメッセージで止まりました。終了コードは 1 です。最後のスタックトレース(at の行から、閉じかっこの } まで)は略しています。
vite v8.3.8 building client environment for production...
transforming...
✓ 16 modules transformed.
✗ Build failed in 90ms
error during build:
Build failed with 1 error:
[UNRESOLVED_IMPORT] Could not resolve './Foo' in src/App.tsx
╭─[ src/App.tsx:1:17 ]
│
1 │ import Foo from "./Foo";
│ ───┬───
│ ╰───── Module not found.
│
│ Help: 'src/App.tsx' is imported by the following path:
│ - src/App.tsx
│ - src/main.tsx
│ - index.html
───╯
開発サーバーの Failed to resolve import の代わりに Could not resolve './Foo' in src/App.tsx と Module not found. が出ますが、指しているのは同じ import です。ファイルの名前を小文字の foo.tsx にした場合も、エラーの種類は同じ [UNRESOLVED_IMPORT] でした(メッセージには、import に書いたパスが出ます)。
import を './components/Foo' に直すと、vite build は ✓ built in 169ms で終わり(終了コードは 0)、npm run build も tsc -b を通ってビルドまで終わりました。ファイル名を Foo.tsx に戻した場合も、vite build は同じように終わりました。





