En esta página

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:

import QtQuick

Item {
    Item {} // ok: no typo in name
}

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.