Warnungen beim Importieren aufgetreten

Diese Warnungskategorie wird von qmllint mit [import] geschrieben.

Modul konnte nicht importiert werden

Was ist passiert?

Das per import-Anweisung importierte Modul wurde nicht gefunden.

Dies kann z.B. verursacht werden durch

  • einen Tippfehler in der import-Anweisung, oder
  • ein benutzerdefiniertes Modul, das nicht erstellt wurde, oder
  • ein falscher Importpfad, oder
  • (nur qmlls) QT_QML_GENERATE_QMLLS_INI ist nicht gesetzt, oder
  • ein fehlendes Modul

Warum ist das schlecht?

Die Anwendung kann nicht ausgeführt werden, weil sie ein Modul, auf das sie angewiesen ist, nicht finden kann.

Beispiele

Tippfehler in der Import-Anweisung

import QtQuicky // not ok: typo in module name

Item {
}

Um diese Warnung zu beheben, korrigieren Sie den Tippfehler:

import QtQuick // ok: no typo in module name

Item {
}

Benutzerdefiniertes Modul, das nicht erstellt wurde

Einige Werkzeuge wie QML Language Server oder qmllint können benutzerdefinierte Module nicht finden, wenn sie nicht gebaut wurden. Wenn Ihr Projekt das QML-Modul definiert, das Sie zu importieren versuchen, dann wird das QML-Tooling es erst finden, wenn Sie es gebaut haben.

Hinweis: Wenn die Erstellung des Moduls nicht hilft, wenn Sie QML Language Servernicht hilft, befolgen Sie die Anweisungen in den QML Language Server setup instructions und stellen Sie sicher, dass Sie QML Language Server den richtigen Build-Ordner mitteilen.

Falscher Importpfad

Weitere Informationen zu Importpfaden finden Sie in der QML-Importpfad-Dokumentation und in der Dokumentation zum Debugging-Modulimport.

QT_QML_GENERATE_QMLLS_INI wird nicht ausgeführt

Bitte lesen Sie in der QT_QML_GENERATE_QMLLS_INI Dokumentation nach, wie Sie diese CMake-Variable setzen können.

Fehlendes Modul

Wenn die vorherigen Abschnitte nicht geholfen haben, das importierte Modul zu finden, könnte es fehlen. Dies kann durch eine fehlende Abhängigkeit verursacht werden. Wenn Sie externe Bibliotheken verwenden, überprüfen Sie, ob diese tatsächlich installiert sind und ob ihre Module in einem Importpfad landen.

Komponente wurde nicht gefunden

Was ist passiert?

Eine Komponente wurde nicht gefunden.

Warum ist das schlecht?

Die Anwendung kann nicht ausgeführt werden, weil sie die nicht gefundene Komponente nicht instanziieren kann.

Beispiele

Tippfehler im Komponentennamen

import QtQuick

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

Um diese Warnung zu beheben, korrigieren Sie den Tippfehler:

import QtQuick

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

Fehlende Import-Anweisung

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

Fügen Sie den fehlenden Modulimport hinzu, um diese Warnung zu beheben:

import QtQuick

Item { // ok: was imported from QtQuick
}

Import-Qualifier muss mit einem Großbuchstaben beginnen

Was ist passiert?

Ein importiertes Modul hat einen ungültigen Bezeichner.

Warum ist das schlecht?

Das mit diesem ungültigen Qualifier importierte Modul kann nicht verwendet werden.

Beispiele

import QtQuick as qq

qq.Item {
}

Um diese Warnung zu beheben, lassen Sie den Import-Qualifier mit einem Großbuchstaben beginnen:

import QtQuick as Qq

Qq.Item {
}

Unbekannte Importsyntax

Was ist passiert?

Eine Importanweisung verwendet eine ungültige Importsyntax.

Warum ist das schlecht?

Die Anwendung kann nicht ausgeführt werden, weil sie ein Modul, auf das sie angewiesen ist, nicht importieren kann.

Beispiele

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

Item {
}

Um diese Warnung zu beheben, verwenden Sie URLs, die ein zulässiges Schema haben:

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

Item {
}

Hinweis: In diesem Beispiel wird davon ausgegangen, dass Sie nicht URL handlers verwenden.

Siehe auch Import-Anweisungen.

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