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