Se han producido advertencias durante la importación
qmllint denomina esta categoría de advertencias « [import] ».
Error al importar el módulo
¿Qué ha pasado?
No se ha encontrado el módulo importado mediante la instrucción «import ».
Esto puede deberse, por ejemplo, a
- un error tipográfico en la instrucción «import», o
- un módulo definido por el usuario que no se ha compilado, o
- una ruta de importación incorrecta, o
- un módulo que falta
¿Por qué es un problema?
La aplicación no puede ejecutarse porque no encuentra un módulo del que depende.
Ejemplos
Error ortográfico en la instrucción de importación
import QtQuicky // not ok: typo in module name
Item {
}Para solucionar esta advertencia, corrige el error tipográfico:
import QtQuick // ok: no typo in module name
Item {
}Módulo definido por el usuario que no se ha compilado
Algunas herramientas, como QML Language Server o qmllint, no pueden encontrar módulos definidos por el usuario cuando no se han compilado. Si tu proyecto define el módulo QML que estás intentando importar, las herramientas de QML no lo encontrarán hasta que lo compiles.
Nota: Si compilar el módulo no soluciona el problema al utilizar QML Language Server, sigue las instrucciones de configuración deQML Language Server y asegúrate de indicar la carpeta de compilación correcta a QML Language Server.
Ruta de importación incorrecta
Consulta la documentación sobre rutas de importación de QML y la documentación sobre depuración de la importación de módulos para obtener más información sobre las rutas de importación.
Módulo ausente
Si las secciones anteriores no te han ayudado a localizar el módulo importado, es posible que falte. Esto podría deberse a una dependencia que falta. Cuando utilices bibliotecas externas, comprueba que estén realmente instaladas y que sus módulos se encuentren en una ruta de importación.
No se ha encontrado el componente
¿Qué ha pasado?
No se ha encontrado algún componente.
¿Por qué es un problema?
La aplicación no puede ejecutarse porque no puede instanciar el componente que no se ha encontrado.
Ejemplos
Error ortográfico en el nombre del componente
import QtQuick
Item {
Itemy {} // not ok: typo in name
}Para solucionar esta advertencia, corrige el error ortográfico:
Falta la instrucción de importación
Item { // not ok: must be imported from QtQuick first
}Para solucionar esta advertencia, añade la importación del módulo que falta:
import QtQuick
Item { // ok: was imported from QtQuick
}El calificador de importación debe comenzar con mayúscula
¿Qué ha pasado?
Algún módulo importado tiene un calificador no válido.
¿Por qué es un problema?
El módulo importado con este calificador no válido no se puede utilizar.
Ejemplos
import QtQuick as qq
qq.Item {
}Para solucionar esta advertencia, haz que el calificador de importación empiece por una letra mayúscula:
import QtQuick as Qq
Qq.Item {
}Sintaxis de importación desconocida
¿Qué ha pasado?
Una instrucción de importación utiliza una sintaxis de importación no válida.
¿Por qué es un problema?
La aplicación no puede ejecutarse porque no puede importar un módulo del que depende.
Ejemplos
import "¯\(ツ)/¯:/path/to/Module"
import QtQuick
Item {
}Para solucionar esta advertencia, utiliza direcciones URL que tengan un esquema permitido:
import "qrc:/path/to/Module"
import QtQuick
Item {
}Nota: En este ejemplo se da por hecho que no estás utilizando URL handlers.
Véase también «Declaraciones de importación».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.