vite · Compilación y tipos
El mensaje
Failed to resolve import "./utils" from "src/main.ts". Does the file exist?
Qué significa
No se encontró nada en esa ruta, y el "Does the file exist?" que imprime apunta a las tres cosas que de verdad hay que revisar: las mayúsculas, la extensión y cualquier alias en tsconfig o vite.config. Los sistemas de archivos de macOS y Windows ignoran las mayúsculas, así que ./Utils funciona en tu máquina y falla por primera vez en CI o en el despliegue, donde Linux sí distingue: este error es la identidad más común de "pero en mi máquina funciona". git ls-files src | grep -i utils muestra con qué grafía está realmente en el repositorio. Para un alias como @/utils, resolve.alias de vite.config y paths de tsconfig deben coincidir; si arreglas solo uno, el editor calla y la compilación sigue rota.
El arreglo
git ls-files src | grep -i utils- Lo imprime
- vite
- Compilación y tipos
- 10
Los errores de compilación son una herramienta que se niega antes de que nada se ejecute, así que no rompen nada en el momento en que aparecen, pero plantean dos preguntas: ¿arreglarás el tipo o la ruta para que coincidan con la forma real, o empujarás esa única línea con un as any o un comentario de supresión? Y es aquí donde las cosas que solo son ciertas en tu máquina —mayúsculas, extensiones y variables de entorno— se muestran por primera vez.
Cómo leer un mensaje de error
- Lee desde la primera línea. Cuanto más abajo, más son las tripas de la herramienta; la causa suele estar arriba.
- Si hay un archivo y un número de línea, empieza ahí: no el marco superior de la pila, sino la línea más alta que nombre un archivo tuyo.
- Busca el mensaje literal, pero quita antes tus rutas y nombres de variables: eso es lo que impide que la búsqueda coincida.
- La misma condición se redacta distinto según la versión. Si los resultados no cuadran, añade el número de versión.
- Antes de pegar un arreglo, comprueba qué descarta. Algunos no se pueden deshacer.
Preguntas frecuentes
Q. ¿Qué significa «Failed to resolve import "./utils" from "src/main.ts". Does the file exist?»?
No se encontró nada en esa ruta, y el "Does the file exist?" que imprime apunta a las tres cosas que de verdad hay que revisar: las mayúsculas, la extensión y cualquier alias en tsconfig o vite.config. Los sistemas de archivos de macOS y Windows ignoran las mayúsculas, así que ./Utils funciona en tu máquina y falla por primera vez en CI o en el despliegue, donde Linux sí distingue: este error es la identidad más común de "pero en mi máquina funciona". git ls-files src | grep -i utils muestra con qué grafía está realmente en el repositorio. Para un alias como @/utils, resolve.alias de vite.config y paths de tsconfig deben coincidir; si arreglas solo uno, el editor calla y la compilación sigue rota.
Q. ¿Cómo se arregla?
git ls-files src | grep -i utils — antes de ejecutarlo, mira arriba qué descarta este comando.
Q. ¿Qué herramienta lo imprime?
vite. Está en Compilación y tipos y el mensaje tiene 11 palabras.