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 個詞。