インポート中に警告が発生しました
この警告カテゴリは、qmllint では「[import] 」と表記されます。
モジュールのインポートに失敗しました
何が起きたのですか?
import 文でインポートしようとしたモジュールが見つかりませんでした。
この原因としては、例えば次のようなものが考えられます。
- import 文のタイプミス、あるいは
- ビルドされていないユーザー定義モジュール、または
- インポートパスが間違っている、あるいは
- モジュールが見つからない
なぜこれが問題なのでしょうか?
アプリケーションが依存しているモジュールが見つからないため、アプリケーションを実行できません。
例
インポート文のタイプミス
import QtQuicky // not ok: typo in module name
Item {
}この警告を解消するには、誤字を修正してください:
import QtQuick // ok: no typo in module name
Item {
}ビルドされていないユーザー定義モジュール
QML Language Server やqmllintなどの一部のツールは、ビルドされていないユーザー定義モジュールを検出できません。プロジェクトでインポートしようとしている QML モジュールが定義されている場合、それをビルドするまでは QML ツールはそれを検出できません。
注: QML Language Serverを使用してもモジュールのビルドが解決しない場合は、QML Language Server のセットアップ手順に従い、QML Language Server に正しいビルドフォルダを確実に通知してください。
インポートパスの誤り
インポートパスに関する詳細については、QML インポートパスのドキュメントおよびモジュールインポートのデバッグに関するドキュメントを参照してください。
モジュールが見つからない
前のセクションの手順を実行してもインポートされたモジュールが見つからない場合は、そのモジュールが存在しない可能性があります。これは、依存関係が欠落していることが原因である可能性があります。外部ライブラリを使用している場合は、それらが実際にインストールされていること、およびそれらのモジュールがインポートパスに含まれていることを確認してください。
コンポーネントが見つかりませんでした
何が起きたのでしょうか?
一部のコンポーネントが見つかりませんでした。
なぜ問題なのでしょうか?
見つからなかったコンポーネントをインスタンス化できないため、アプリケーションを実行できません。
例
コンポーネント名のスペルミス
import QtQuick
Item {
Itemy {} // not ok: typo in name
}この警告を修正するには、スペルミスを修正してください:
import文の欠落
Item { // not ok: must be imported from QtQuick first
}この警告を修正するには、欠落しているモジュールのインポートを追加してください:
import QtQuick
Item { // ok: was imported from QtQuick
}インポート修飾子は大文字で始まる必要があります
何が起きたのでしょうか?
インポートされたモジュールの一部に無効な修飾子があります。
なぜ問題なのでしょうか?
この無効な修飾子でインポートされたモジュールは使用できません。
例
import QtQuick as qq
qq.Item {
}この警告を解消するには、インポート修飾子を大文字で始めるようにしてください:
import QtQuick as Qq
Qq.Item {
}不明なインポート構文
何が起きたのですか?
インポート文で無効なインポート構文が使用されています。
なぜ問題なのか?
アプリケーションが依存しているモジュールをインポートできないため、実行できません。
例
import "¯\(ツ)/¯:/path/to/Module"
import QtQuick
Item {
}この警告を修正するには、許可されたスキームを持つURLを使用してください:
import "qrc:/path/to/Module"
import QtQuick
Item {
}注:この例では 、URL handlers を使用していないことを前提としています。
「インポート文」も参照してください 。
© 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.