Using Language Servers

For several programming languages, a language server offers information about the code to IDEs as long as they support communication via the language server protocol (LSP). This enables the IDE to offer the following services:

By providing a client for the language server protocol, Qt Creator can support the above features for several other programming languages besides C++. However, the client does not support language servers that require special handling.

Adding MIME Types for Language Servers

Qt Creator uses the MIME type of the file to determine which language server to request information from when you open a file for editing. Add new MIME types or file patterns to match language servers. If you do not set at least one MIME type or file pattern, no files will be sent to the language server. This is done to avoid unnecessary traffic and inaccurate information, as files are only sent to the language server if they are known to be handled by it. For more information about how Qt Creator uses MIME types, see Editing MIME Types.

Specifying Settings for Language Clients

Qt Creator supports adding a Java language server for Android development. A Python language server is added by default and you can edit its preferences. For other languages, you can add generic stdIO language servers.

To add language servers, select Edit > Preferences > Language Client > Add (or Qt Creator > Preferences > Language Client > Add on macOS).

To enable a language server, select the check box next to the language server name and set server preferences.

To remove language servers from the list, select Delete.

Generic StdIO Language Server

To add a generic language server:

  1. Select Edit > Preferences > Language Client > Add > Generic StdIO Language Server to add a generic language server.

  2. In the Name field, enter a name for the language server. Select the (Variables) button to use a variable for the server name. For more information, see Using Qt Creator Variables.
  3. In the Language field, select Set MIME Types to select the MIME types of the files to send to the language server. In the field below, you can enter file patterns to extend the MIME types, separated by semicolons.
  4. In the Startup behavior field, select whether the language server is started when Qt Creator starts or when a project or file with a matching MIME type is opened. General Messages displays information about the connection to the language server.
  5. In the Initialization options field, you can add language server specific JSON attributes to pass to an initialize request.
  6. In the Executable field, enter the path to the language server executable.
  7. In the Arguments field, enter any required command line arguments. Select Variables to use variables as arguments.

Java Language Server

To add a Java language server:

  1. Select Edit > Preferences > Language Client > Add > Java Language Server to add a Java language server.

    "Java language server preferences"

  2. In the Name field, enter a name for the language server. Select the (Variables) button to use a variable for the server name. For more information, see Using Qt Creator Variables.
  3. In the Java field, enter the path to the Java executable.
  4. In the Java Language Server field, enter the path to the Java language server .jar file. You can download the Java language server from Eclipse Downloads.

Python Language Server

To set preferences for Python language servers:

  1. Select Edit > Preferences > Python > Language Server Configuration to select the Python language server plugins to use.

    "Python Language Server Configuration"

  2. Select Advanced to configure the plugins.

    "Python language server plugin configuration"

For a complete list of configuration options, see Python Language Server Configuration.

To disable the Python language server, deselect Use Python Language Server.

QML Language Server

Since Qt 6.4, the qmlls language server offers code completion and issues warnings for QML. To enable QML language server support, select Edit > Preferences > Qt Quick > QML/JS Editing > Use qmlls (EXPERIMENTAL!). To use the latest version of the language server installed on your system, select the Always use latest qmlls check box.

{QML/JS Editing preferences}

Supported Locator Filters

The locator enables you to browse not only files, but any items defined by locator filters. The language client plugin supports the following locator filters:

  • Locating symbols in the current project (:)
  • Locating symbols in the current document (.)
  • Locating class (c), enum, and function (m) definitions in your project

Inspecting Language Clients

Qt Creator sends messages (Requests) to the language server and receives responses that have the requested information if the language server is capable of handling the requests. To inspect the communication between Qt Creator and language servers and view server capabilities, select Tools > Debug Qt Creator > Inspect Language Clients.

"Language Client Inspector dialog"

The dialog shows a list of running language servers. The value of the Startup behavior field in the language server preferences determines when the server is started. The information displayed depends on the language server.

Select the button on the editor toolbar, and then select Restart to restart language servers.

Log displays additional information about the selected log entry. You can see the Content length and MIME type of a Client Message and Server Message, as well as inspect the data sent between Qt Creator and the language server.

To remove old entries, select Clear.

Capabilities

In Capabilities, you can check whether a language server is capable of a specific task. You cannot modify the server capabilities in this dialog.

You can view the Name, Value, and Type of the capability.

"Language Client Inspector Capabilities tab"

For some language servers, Dynamic Capabilities lists the Methods and Options available.

Memory Usage

For a clangd server, you can inspect the total amount of memory used by a particular component in Memory Usage.

"Language Client Inspector Memory Usage tab"

Reporting Issues

The language server client has been mostly tested with Python and Java. If problems arise when you try them or some other language, please select Help > Report Bug to report them in the Qt Project Bug Tracker. The reports should include Qt Creator console output with the environment variable QT_LOGGING_RULES=qtc.languageclient.*=true set.

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