Sur cette page

Des avertissements se sont produits lors de l'importation

Cette catégorie d'avertissement est orthographiée « [import] » par qmllint.

Échec de l'importation du module

Que s'est-il passé ?

Le module importé via l'instruction « import » est introuvable.

Cela peut être dû, par exemple, à

  • une faute de frappe dans l'instruction « import », ou
  • un module défini par l'utilisateur qui n'a pas été compilé, ou
  • un chemin d'importation incorrect, ou
  • un module manquant

Pourquoi est-ce un problème ?

L'application ne peut pas s'exécuter car elle ne trouve pas un module dont elle dépend.

Exemples

Faute de frappe dans l'instruction d'importation

import QtQuicky // not ok: typo in module name

Item {
}

Pour corriger cet avertissement, corrigez la faute de frappe :

import QtQuick // ok: no typo in module name

Item {
}

Module défini par l'utilisateur qui n'a pas été compilé

Certains outils, tels que QML Language Server ou qmllint, ne parviennent pas à détecter les modules définis par l'utilisateur lorsqu'ils n'ont pas été compilés. Si votre projet définit le module QML que vous essayez d'importer, les outils QML ne le détecteront pas tant que vous ne l'aurez pas compilé.

Remarque : si la compilation du module ne résout pas le problème lorsque vous utilisez QML Language Server, suivez les instructions de configuration disponibles à l'adresseQML Language Server et assurez-vous d'indiquer le dossier de compilation correct à QML Language Server.

Chemin d'importation incorrect

Veuillez vous reporter à la documentation sur les chemins d'importation QML et à celle sur le débogage de l'importation de modules pour plus d'informations sur les chemins d'importation.

Module manquant

Si les sections précédentes ne vous ont pas aidé à localiser le module importé, il se peut qu’il soit manquant. Cela peut être dû à une dépendance manquante. Lorsque vous utilisez des bibliothèques externes, vérifiez qu’elles sont bien installées et que leurs modules se trouvent bien dans un chemin d’importation.

Composant introuvable

Que s'est-il passé ?

Un composant n'a pas été trouvé.

Pourquoi est-ce un problème ?

L'application ne peut pas s'exécuter car elle ne peut pas instancier le composant introuvable.

Exemples

Faute de frappe dans le nom du composant

import QtQuick

Item {
    Itemy {} // not ok: typo in name
}

Pour corriger cet avertissement, corrigez la faute de frappe :

import QtQuick

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

Déclaration d'import manquante

Item { // not ok: must be imported from QtQuick first
}

Pour corriger cet avertissement, ajoutez l'importation du module manquante :

import QtQuick

Item { // ok: was imported from QtQuick
}

Le qualificateur d'importation doit commencer par une majuscule

Que s'est-il passé ?

Un module importé possède un qualificateur non valide.

Pourquoi est-ce un problème ?

Le module importé avec ce qualificateur non valide ne peut pas être utilisé.

Exemples

import QtQuick as qq

qq.Item {
}

Pour corriger cet avertissement, veillez à ce que le qualificateur d'importation commence par une majuscule :

import QtQuick as Qq

Qq.Item {
}

Syntaxe d'importation inconnue

Que s'est-il passé ?

Une instruction d'importation utilise une syntaxe d'importation non valide.

Pourquoi est-ce un problème ?

L'application ne peut pas s'exécuter car elle ne parvient pas à importer un module dont elle dépend.

Exemples

import "¯\(ツ)/¯:/path/to/Module"
import QtQuick

Item {
}

Pour corriger cet avertissement, utilisez des URL dont le schéma est autorisé :

import "qrc:/path/to/Module"
import QtQuick

Item {
}

Remarque : cet exemple part du principe que vous n'utilisez pas URL handlers.

Voir aussi les instructions d'importation.

© 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.