En esta página

QML Language Server

QML Language Server es una herramienta incluida con Qt que te ayuda a escribir código en tu editor favorito (compatible con LSP). Consulta el Protocolo de servidor de lenguaje (LSP) para obtener más información.

Actualmente, permite que tu editor:

  • Autocompletar tu código
  • Mostrar advertencias de qmllint
  • Navegar hasta las definiciones en archivos QML
  • Buscar las apariciones de variables de JavaScript y objetos QML
  • Renombrar variables de JavaScript y objetos de QML
  • Dar formato a los archivos QML
  • Obtener ayuda de la documentación de Qt

Nota: « qmlls » se encuentra actualmente en desarrollo; consulta «Limitaciones conocidas» para obtener más detalles.

Funciones compatibles

Validación

QML Language Server puede realizar automáticamente la revisión de los archivos QML abiertos y mostrar advertencias o errores directamente en el editor. Consulta qmllint para obtener más información sobre el proceso de revisión, y Advertencias y errores de QML Lint sobre cómo corregir las advertencias y los errores.

Formateo

QML Language Server puede dar formato a archivos completos desde el propio editor. Consulta qmlformat para obtener más información sobre el proceso de formateo.

Búsqueda de definiciones

QML Language Server permite buscar definiciones de variables de JavaScript, funciones, identificadores de objetos QML y propiedades QML a partir de sus usos.

QML Language Server También puede buscar la definición de los tipos utilizados en las anotaciones de tipo para funciones de JavaScript, propiedades de objetos QML y la instanciación de objetos QML.

Búsqueda de usos

QML Language Server Puede buscar usos de variables de JavaScript, propiedades de objetos QML, funciones de JavaScript, métodos de objetos QML e identificadores de objetos QML.

Cambiar el nombre

QML Language Server Puede cambiar el nombre de variables y funciones de JavaScript, así como de propiedades, métodos e identificadores de objetos QML, siempre que estén definidos en un archivo QML.

Sugerencias de autocompletado

QML Language Server ofrece sugerencias de autocompletado para variables, expresiones y sentencias de JavaScript, así como para propiedades, métodos e identificadores de objetos QML.

Seguimiento de cambios en archivos C++

QML Language Server permite realizar un seguimiento de los cambios en los archivos C++ que definen tipos QML. Recompila automáticamente los módulos QML de CMake para proporcionar advertencias y sugerencias de autocompletado precisas y actualizadas para los tipos QML definidos en C++.

Puedes desactivar esta función.

Sugerencias de documentación

QML Language Server incluye una función de sugerencias de documentación que ofrece a los programadores un acceso rápido a la documentación de Qt al pasar el cursor por encima de una palabra clave. Para utilizar esta función, tu kit de Qt debe contener la documentación de Qt y tu proyecto debe compilarse con la variable QT_QML_GENERATE_QMLLS_INI.

Configuración de « QML Language Server » en tu editor

En esta sección se describe cómo desarrollar el cliente « QML Language Server » o cómo utilizar su propio cliente « QML Language Server ».

Puedes encontrar el binario de QML Language Server en <Qt installation folder>/bin/qmlls en las instalaciones de Qt realizadas con Qt Online Installer. Si quieres que tu cliente QML Language Server descargue el binario directamente, puedes descargar la versión independiente desde GitHub a través de https://github.com/TheQtCompanyRnD/qmlls-workflow/releases o https://qtccache.qt.io/QMLLS/LatestRelease.

Configuración del directorio de compilación

QML Language Server necesita conocer la ubicación de la carpeta de compilación del proyecto. Puedes indicar la carpeta de compilación de las siguientes formas.

Extensión LSP «AddBuildDirs»

Para indicar los directorios de compilación a través de la extensión LSP, envía una notificación a QML Language Server utilizando el método $/addBuildDirs. $/addBuildDirs acepta un parámetro con el siguiente formato:

interface AddBuildDirsParams {
    buildDirsToSet: UriToBuildDirs[];
}

donde UriToBuildDirs contiene un URI del espacio de trabajo y una lista de directorios de compilación. El URI del espacio de trabajo debe designar un espacio de trabajo anunciado a QML Language Server a través de workspaceFolders o didChangeWorkspaceFolders. Los directorios de compilación son rutas de archivo, no URI.

interface UriToBuildDirs {
    baseUri: URI;
    buildDirs: string[];
}

Opción de línea de comandos –build-dir

Si no necesitas admitir varios espacios de trabajo, puedes pasar los directorios de compilación mediante la opción de línea de comandos --build-dir. En este caso, tu editor debería invocar qmlls de la siguiente manera:

<path/to/qmlls> ... --build-dir <path/to/build-directory> ...

El directorio de compilación se aplicará a todos los espacios de trabajo si utilizas varios espacios de trabajo en el mismo ` QML Language Server`. Los valores de ` addBuildDirsMethod ` tienen mayor prioridad que la opción de línea de comandos.

Variable de entorno QMLLS_BUILD_DIRS

También puede especificar los directorios de compilación mediante la variable de entorno QMLLS_BUILD_DIRS. El directorio de compilación se aplicará a todos los espacios de trabajo si utiliza varios espacios de trabajo en el mismo QML Language Server. Los valores de --build-dir tienen mayor prioridad que la variable de entorno.

.qmlls.ini Archivo de configuración

Si no puede especificar los directorios de compilación mediante ninguna de las opciones anteriores, puede intentar indicarlos a QML Language Server a través de un archivo de configuración. Véase también «Archivo de configuración». Los valores del archivo de configuración tienen menor prioridad que --build-dir, QMLLS_BUILD_DIRS y addBuildDirsMethod.

Configuración de compilaciones automáticas con CMake

QML Language Server intentará activar una recompilación de CMake cuando detecte que se ha modificado el código fuente de un tipo QML definido en C++.

Para desactivar esta función, utiliza los siguientes métodos:

Para controlar el número de tareas que utiliza CMake, utiliza

  • la opción de línea de comandos « --cmake-jobs ». En este caso, su editor debería invocar « qmlls » de la siguiente manera:
    <path/to/qmlls> --build-dir <path/to/build-directory> --cmake-jobs <jobs>
  • La variable de entorno ` QMLLS_CMAKE_JOBS `.
  • El archivo de configuración de ` .qmlls.ini `; véase «Archivo de configuración».

Los valores aceptados son números enteros mayores que 0 y max para utilizar todos los núcleos disponibles.

QML Language Server establece un límite del número de archivos que se buscarán al explorar las carpetas de origen en busca de encabezados, por ejemplo, al acceder a la definición de un componente QML definido en un encabezado de C++.

Para establecer el número máximo de archivos que se van a buscar, escribe un valor numérico en la variable de entorno QMLLS_MAX_FILES_TO_SEARCH. El valor 0 desactiva la función de búsqueda de archivos; 20000 es el valor por defecto.

Archivo de configuración

QML Language Server Se puede configurar mediante un archivo de configuración .qmlls.ini. Este archivo debe encontrarse en el directorio raíz de fuentes del proyecto. Debe ser un archivo de texto en formato ini.

El archivo de configuración puede contener las siguientes entradas:

// .qmlls.ini
[General]
no-cmake-calls=<true-or-false>
CMakeJobs=<some integer value>

buildDir=<path/to/build-directory> # not required in Qt 6.10 and later
docDir=<path/to/qt-documentation>  # not required in Qt 6.10 and later
importPaths=<path/to/imports>      # not required in Qt 6.10 and later

Para utilizar el archivo de configuración con el fin de desactivar la funcionalidad de reconstrucción automática de CMake, establece no-cmake-calls en true.

Para controlar el número de tareas utilizadas por las reconstrucciones automáticas de CMake, configura el valor de CMakeJobs.

Para dar soporte a clientes que no pueden pasar el directorio de compilación a ` QML Language Server`, tal y como se describe en «Configuración del directorio de compilación», establece el valor de `buildDir` o deja que CMake genere el archivo `.qmlls.ini` mediante `QT_QML_GENERATE_QMLLS_INI`.

Nota: QML Language Server puede crear archivos de configuración predeterminados utilizando la opción --write-defaults. Esto sobrescribirá cualquier archivo .qmlls.ini ya existente en el directorio actual.

Limitaciones conocidas

A pesar de que cubre muchas características comunes de QML, QML Language Server aún se encuentra en fase de desarrollo y hay algunas características que aún no son compatibles:

  • Sugerir autocompletados en archivos QML no válidos.
  • Autocompletado de propiedades de contexto

QML Language Server puede generar falsas alertas en proyectos

  • que utilicen QMake o el registro de tipos imperativo; véase Portar módulos QML a CMake
  • que no se hayan compilado—QML Language Server utiliza la información de compilación para localizar módulos QML
  • en los que los módulos QML no siguen las directrices de Modernización de módulos QML

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