vite · Build e tipos
A mensagem
Failed to resolve import "./utils" from "src/main.ts". Does the file exist?
O que significa
Nada foi encontrado naquele caminho, e o "Does the file exist?" que ele imprime aponta para as três coisas que realmente vale checar: a caixa das letras, a extensão e qualquer alias em tsconfig ou vite.config. Os sistemas de arquivos do macOS e do Windows ignoram maiúsculas, então ./Utils funciona na sua máquina e quebra pela primeira vez na CI ou no deploy, onde o Linux se importa — este erro é a identidade mais comum de "mas na minha máquina funciona". git ls-files src | grep -i utils mostra a grafia que o repositório realmente guarda. Para um alias como @/utils, resolve.alias no vite.config e paths no tsconfig precisam concordar; corrija só um e o editor fica calado enquanto o build continua falhando.
A correção
git ls-files src | grep -i utils- Impresso por
- vite
- Build e tipos
- 10
Erros de build são uma ferramenta recusando antes de qualquer execução, então não quebram nada no momento em que aparecem — mas fazem duas perguntas: você vai corrigir o tipo ou o caminho para bater com a forma real, ou vai empurrar aquela linha com um as any ou um comentário de supressão? E é aqui que as coisas verdadeiras só na sua máquina — caixa das letras, extensões e variáveis de ambiente — aparecem pela primeira vez.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “Failed to resolve import "./utils" from "src/main.ts". Does the file exist?”?
Nada foi encontrado naquele caminho, e o "Does the file exist?" que ele imprime aponta para as três coisas que realmente vale checar: a caixa das letras, a extensão e qualquer alias em tsconfig ou vite.config. Os sistemas de arquivos do macOS e do Windows ignoram maiúsculas, então ./Utils funciona na sua máquina e quebra pela primeira vez na CI ou no deploy, onde o Linux se importa — este erro é a identidade mais comum de "mas na minha máquina funciona". git ls-files src | grep -i utils mostra a grafia que o repositório realmente guarda. Para um alias como @/utils, resolve.alias no vite.config e paths no tsconfig precisam concordar; corrija só um e o editor fica calado enquanto o build continua falhando.
Q. Como corrigir?
git ls-files src | grep -i utils — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
vite. Fica em Build e tipos e a mensagem tem 11 palavras.