Auf dieser Seite

Beim Import sind Warnungen aufgetreten

Diese Warnkategorie wird von qmllint als „ [import] “ bezeichnet.

Modul konnte nicht importiert werden

Was ist passiert?

Das über die import-Anweisung importierte Modul wurde nicht gefunden.

Dies kann beispielsweise folgende Ursachen haben:

  • einem Tippfehler in der import-Anweisung oder
  • einem benutzerdefinierten Modul, das nicht erstellt wurde, oder
  • einen falschen Importpfad oder
  • einem fehlenden Modul

Warum ist das ein Problem?

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

Beispiele

Tippfehler in der Importanweisung

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 Tools wie QML Language Server oder qmllint können benutzerdefinierte Module nicht finden, wenn diese nicht kompiliert wurden. Wenn Ihr Projekt das QML-Modul definiert, das Sie importieren möchten, können die QML-Tools es erst finden, wenn Sie es kompilieren.

Hinweis: Wenn das Kompilieren des Moduls bei der Verwendung von QML Language Server, befolgen Sie die Anweisungen in den Einrichtungsanweisungen fürQML Language Server und stellen Sie sicher, dass Sie den korrekten Build-Ordner an QML Language Server übermitteln.

Falscher Importpfad

Weitere Informationen zu Importpfaden finden Sie in der Dokumentation zu QML-Importpfaden und in der Dokumentation zum Debuggen von Modulimporten.

Fehlendes Modul

Falls die vorherigen Abschnitte nicht dabei geholfen haben, das importierte Modul zu finden, fehlt es möglicherweise. Dies könnte 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 enthalten sind.

Komponente wurde nicht gefunden

Was ist passiert?

Eine Komponente wurde nicht gefunden.

Warum ist das ein Problem?

Die Anwendung kann nicht ausgeführt werden, da 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
}

Um diese Warnung zu beheben, fügen Sie den fehlenden Modul-Import hinzu:

import QtQuick

Item { // ok: was imported from QtQuick
}

Der Import-Qualifizierer muss mit einem Großbuchstaben beginnen

Was ist passiert?

Ein importiertes Modul hat einen ungültigen Qualifizierer.

Warum ist das ein Problem?

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

Beispiele

import QtQuick as qq

qq.Item {
}

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

import QtQuick as Qq

Qq.Item {
}

Unbekannte Import-Syntax

Was ist passiert?

Eine Importanweisung verwendet eine ungültige Import-Syntax.

Warum ist das ein Problem?

Die Anwendung kann nicht ausgeführt werden, da 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 mit einem zulässigen Schema:

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

Item {
}

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

Siehe auch Import-Anweisungen.

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