Qtの設定
Qtの設定を表示または変更するには、Command Palette にアクセスし、「Qt: Open Qt Extension settings 」を選択してください。
設定での変数の使用
Qt Extension for VS Code は、Qt 設定における変数の置換をサポートしています。利用可能な変数については、以下の変数リファレンスを参照してください。
| 変数 | 説明 |
|---|---|
${userHome} | ユーザーのホームディレクトリに展開されます。 |
${workspaceFolder} | 現在のワークスペースのルートディレクトリへのフルパスに展開されます。 パスにこの変数を接頭辞として付けることで、現在のワークスペースを基準としたQtのインストール先やQML Language Server 実行ファイルへのパスを指定できます。たとえば、ワークスペースの一部としてYocto SDKとそのQtバージョンを使用している場合などです。 |
Qt C++の設定
C++ 言語の設定。
| 設定 | 説明 |
|---|---|
| Disable Auto Kit Generation On Open | VS Codeの起動時にcmake-kits.json の自動スキャンと更新を無効にします。これは、キットを手動で管理している場合や、cmake-kits.json をバージョン管理下に置いている場合に便利です。 |
| Do Not Ask for CMake Path | CMake Tools が PATH 環境変数を検索し、CMake の場所を推測できるようにします。 |
| Do Not Warn Missing Source Dir | キットからソースディレクトリを検出できないという警告を非表示にします。これは、たとえば vcpkg を使って Qt をインストールした場合などに発生する可能性があります。詳細については、「Qt アプリケーションのデバッグ」を参照してください。 |
| Do Not Warn Outdated CMake Tools | CMake Tools拡張機能のバージョンが古すぎてプリセットをサポートできないという警告を非表示にします。 |
Qt Core 設定
Qt 拡張機能の共通機能に関する設定。
| 設定 | 説明 |
|---|---|
| Additional Qt Paths | Qt のインストール先を検索するために、qtpaths またはqmake 実行ファイルへのパスを追加します。詳細については、「その他のインストール」を参照してください。 |
| Default Project Directory | 新しいプロジェクトを作成する際に、デフォルトで表示されるフォルダのパスを設定します。詳細については、「Qtプロジェクトの作成」を参照してください。 |
| Do Not Ask for Default Qt Installation Root | Qt Installation Root の値の設定に関するプロンプトを非表示にします。 |
| Do Not Ask for VCPKG | vcpkg 用の CMake キットの作成に関するプロンプトを非表示にします。詳細については、「自動登録」を参照してください。 |
| Enable QRC Editor | QRC ファイルの編集に QRC エディタを使用するか、デフォルトのテキストエディタを使用するかを指定します。詳細については、「QRC ファイルの編集」を参照してください。 |
| Open Online Documentation in External Browser | デフォルトのブラウザで Qt ドキュメントを開きます。詳細については、「Qt ドキュメントの閲覧」を参照してください。 |
| Qt Installation Root | Qt をインストールしたフォルダのパス。詳細については、「自動登録」を参照してください。 |
| Show Welcome Page On Activation | 拡張機能の起動時に、VS Code用Qt XML拡張機能の「Welcome 」ページを表示するかどうか。詳細については、「はじめに」を参照してください。 |
QMLの設定
QML コードの記述およびプレビューに関する設定です。
QML プレビュー設定
QML Live プレビューの設定。詳細については、「 Qt Quick アプリケーションのプレビュー」を参照してください。
| 設定 | 説明 |
|---|---|
| Additional Build Dirs | QML プレビュー中に QRC ファイルを検索する追加のビルドディレクトリ。これは、ビルドディレクトリがワークスペース外にある場合に役立ちます。 |
| Args | コマンドパレットからアプリケーションを起動する際に、アプリケーションに渡すデフォルトのコマンドライン引数。 |
QML Profiler settings
QML Profiler の設定。詳細については、「QMLコードのプロファイル作成」を参照してください。
| 設定 | 説明 |
|---|---|
| Args | QML Profiler を起動する際に、アプリケーションに渡す追加のコマンドライン引数。 |
| Custom Trace Viewer Exe Path | QML Profiler をインストールしたフォルダのパス。 |
QML Language Server settings
設定 QML Language Server。詳細については、「 QML Language Server を有効にする」を参照してください。
| 設定 | 説明 |
|---|---|
| Do Not Ask for Qmlls Download | QML Language Server のダウンロードに関するプロンプトを非表示にします。 |
| Additional Import Paths | 指定されたフォルダ内で QML モジュールを検索し、QML Language Server の起動時に-I コマンドを使用して、それらのモジュールに対するインポート文を追加します。インポートパスを追加するには、[Add Item ] を選択してください。 |
| Custom Args | Add Item を選択すると、デフォルトの引数ではなく、QML Language Server 用のカスタム引数を設定できます。 |
| Custom Docs Path | QML Language Server のドキュメントをインストールしたフォルダのパス。詳細については、「Qtドキュメントの閲覧」を参照してください。 |
| Custom Exe Path | QML Language Server をインストールしたフォルダのパス。 |
| Run QML Language Server when activating an extension | 拡張機能を有効にした際に、QML Language Server を起動します。 |
| Handle LSP Trace | QML Language Server からのトレース出力を収集します。 |
| Use No CMake Calls | `--no-cmake-calls ` オプションを使用して、`QML Language Server` で開始する自動 CMake ビルドを無効にします。 |
| Use QML Import Path Env Var | QML_IMPORT_PATH オプションを使用して、QML モジュールを検索します。この設定を有効にすると、QML Language Server を起動する際に-E 引数が追加されます。 |
| Verbose Output | QML Language Server からの出力を詳細表示します。 |
Qt for Pythonの設定
Qt for Python の設定}" src="images/vscodeext-qt-settings-python.webp" title="{Qt for Python の設定}"/>
Qt for Python を使用した開発に関する設定です。詳細については、「Python 開発」を参照してください。
| 設定 | 説明 |
|---|---|
| Do Not Warn About Old Style Projects | プロジェクトでpyproject.toml ファイルの代わりに.pyproject 設定ファイルを使用することに関する警告を非表示にします。新しいプロジェクトでは、TOML ベースの設定ファイルの使用が推奨されます。詳細については、「Qt for Python: pyside6-project」を参照してください。 |
Qt UI 設定
.uiファイルの取り扱いに関する設定です。詳細については、「ウィジェットベースの UI の設計」を参照してください。
| 設定 | 説明 |
|---|---|
| Custom Widgets Designer Exe Path | Qt Widgets Designer をインストールしたフォルダのパス。 |
© 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.
