vite · ビルドと型
メッセージ
Failed to resolve import "./utils" from "src/main.ts". Does the file exist?
何を意味するか
その経路にファイルが見つからなかったという意味で、一緒に出る "Does the file exist?" が本当に確かめるべき三つを指しています — 名前の大文字小文字、拡張子、そして tsconfig や vite.config の別名です。macOS と Windows のファイルシステムは大文字小文字を区別しないので、./Utils と書いても自分の環境では動き、Linux で動く CI と配備で初めて壊れます — この誤りが「自分の環境では動く」の最も多い正体です。git ls-files src | grep -i utils でリポジトリに実際どの綴りで入っているかを確かめてください。別名（@/utils）なら vite.config の resolve.alias と tsconfig の paths の両方を合わせる必要があり、片方だけ直すと編集器は黙るのにビルドだけ壊れ続けます。
直しかた
git ls-files src | grep -i utils- 出す道具
- vite
- ビルドと型
- 10
ビルドの誤りは実行前に道具が拒んだものなので、その場で何かを壊すわけではありません。代わりに二つを問います — 型や経路を実際の形に合わせて直すのか、それとも as any や抑制のコメント一つでその行だけ通すのか。そして大文字小文字や拡張子、環境変数のように自分の環境でだけ正しいものは、ここで初めて姿を見せます。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. Failed to resolve import "./utils" from "src/main.ts". Does the file exist? はどういう意味ですか。
その経路にファイルが見つからなかったという意味で、一緒に出る "Does the file exist?" が本当に確かめるべき三つを指しています — 名前の大文字小文字、拡張子、そして tsconfig や vite.config の別名です。macOS と Windows のファイルシステムは大文字小文字を区別しないので、./Utils と書いても自分の環境では動き、Linux で動く CI と配備で初めて壊れます — この誤りが「自分の環境では動く」の最も多い正体です。git ls-files src | grep -i utils でリポジトリに実際どの綴りで入っているかを確かめてください。別名（@/utils）なら vite.config の resolve.alias と tsconfig の paths の両方を合わせる必要があり、片方だけ直すと編集器は黙るのにビルドだけ壊れ続けます。
Q. どう直しますか。
git ls-files src | grep -i utils — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
vite です。ビルドと型の仲間で、文句は11語です。