Qt settings

To view and change Qt settings, go to Command Palette and select Qt: Open Qt Settings.

Use variables in settings

Qt Extension for VS Code supports variable substitution in Qt settings. See the following variable reference for the available variables.

VariableDescription
${userHome}Expands to the user's home directory.
${workspaceFolder}Expands to the full path to the root directory of the current workspace.

Prefix the variable to a path to specify a path to the Qt installation or QML Language Server executable that is relative to the current workspace. For example, when using a Yocto SDK and its Qt version as part of the workspace.

Qt C++ settings

{Qt C++ Configuration}

Settings for the C++ language.

SettingDescription
Do Not Ask for CMake pathLets CMake Tools search the PATH environment variable and make some educated guesses on where to find CMake.

Qt Core settings

{Qt Core Configuration}

Settings for the common features of the Qt extensions.

SettingDescription
Additional Qt PathsAdds paths to the qtpaths or qmake executable to find Qt installations. For more information, see Other installations.
Default Project DirectorySets the path to the folder that is shown by default when you create new projects. For more information, see Create Qt projects.
Do Not Ask for Default Qt Installation RootHides the prompt about setting the value of Qt Installation Root.
Do Not Ask for VCPKGHides the prompt about creating a CMake kit for vcpkg. For more information, see Automatic registration.
Open Online Documentation in External BrowserOpens Qt documentation in the default browser. For more information, see Read Qt documentation.
Qt Installation RootPath to the folder where you installed Qt. For more information, see Automatic registration.

QML Language Server settings

{Qt QML Configuration}

Settings for QML Language Server. For more information, see Turn on QML Language Server.

SettingDescription
Do Not Ask for Qmlls DownloadHides the prompt about downloading QML Language Server.
Additional Import PathsLooks for QML modules in the specified folders, and uses the -I command to add import statements for them when you start QML Language Server. Select Add Item to add import paths.
Custom ArgsSelect Add Item to set custom QML Language Server arguments instead of using the default arguments.
Custom Docs PathPath to the folder where you installed QML Language Server documentation. For more information, see Read Qt documentation.
Custom Exe PathPath to the folder where you installed QML Language Server.
Run QML Language Server when activating an extensionTurns on QML Language Server when you activate an extension.
Handle LSP traceCollects trace output from QML Language Server.
Use No CMake CallsUses the --no-cmake-calls option to disable automatic CMake builds you start QML Language Server.
Use QML Import Path Env VarUses the QML_IMPORT_PATH option to look for QML modules. Turn on this setting to add the -E argument when you start QML Language Server.
Verbose OutputShows verbose output from QML Language Server.

Qt UI settings

{Qt UI Configuration}

Settings for handling .ui files. For more information, see Design widgets-based UIs.

SettingDescription
Custom Widgets Designer Exe PathPath to the folder where you installed Qt Widgets Designer.

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