インポート中に発生した警告
この警告カテゴリのスペルは[import]
です。
モジュールのインポートに失敗しました
何が起こりましたか?
import文でインポートしたモジュールが見つかりませんでした。
これは例えば
- import文のタイプミス
- ビルドされていないユーザー定義モジュール。
- 間違ったインポートパス
- (qmlls のみ)QT_QML_GENERATE_QMLLS_INI が設定されていない。
- 不足しているモジュール
なぜ悪いのでしょうか?
依存しているモジュールが見つからないため、アプリケーションが実行できない。
例
インポート文のタイプミス
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のインポートパスのドキュメントおよびデバッギングモ ジュールのインポートドキュメントを参照してください。
QT_QML_GENERATE_QMLLS_INI が挿入されない。
CMake 変数の設定方法についてはQT_QML_GENERATE_QMLLS_INI のドキュメント を参照してください。
モジュールがない
前のセクションでインポートされたモジュールが見つからなかった場合、モジュールが見つからない可能性があります。これは依存関係が見つからないことが原因かもしれません。外部ライブラリを使用する場合は、それらのライブラリが実際にインストールされていること、そしてそのモジュールがインポートパスに含まれていることを確認してください。
コンポーネントが見つかりません
何が起こったのですか?
コンポーネントが見つかりませんでした。
なぜ悪いのですか?
見つからなかったコンポーネントをインスタンス化できないため、アプリケーションを実行できない。
例
コンポーネント名のタイプミス
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文が無効なimport構文を使用しています。
なぜ悪いのか?
依存するモジュールをインポートできないため、アプリケーションを実行できない。
例
import "¯\(ツ)/¯:/path/to/Module"
import QtQuick
Item {
}
この警告を修正するには、許可されたスキームを持つURLを使用してください:
import "qrc:/path/to/Module"
import QtQuick
Item {
}
注意: この例では、URL handlers を使用していないことを仮定しています。
Import Statementsも参照してください 。
© 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.