En esta página

Qt para Windows: compilación a partir del código fuente

Esta página describe el proceso de configuración y compilación de Qt para Windows. Para descargar e instalar una versión precompilada de Qt para Windows, sigue las instrucciones de la página «Primeros pasos con Qt ».

Paso 1: Obtener el código fuente

Los códigos fuente de Qt se pueden descargar en Qt Online Installer. Los paquetes fuente también están disponibles a través de Git, como archivos comprimidos en la cuenta de Qt (para usuarios comerciales) y en download.qt.io (para usuarios de código abierto).

Si instalas los códigos fuente a través de Qt Online Installer, estarán disponibles en el directorio de instalación de Qt, por ejemplo C:\Qt\6.12.0\Src.

Si has descargado el archivo fuente, extráelo en un directorio de tu elección, por ejemplo, C:\dev\Qt\src.

Nota: La ruta al directorio de fuentes no debe contener espacios ni caracteres específicos del sistema de archivos de Windows. Además, la ruta debe ser breve. Esto evita problemas con rutas de archivo demasiado largas durante la fase de compilación.

Paso 2: Instalación de los requisitos de compilación y configuración del entorno

Para compilar Qt a partir del código fuente, necesitas un entorno de compilación con un compilador compatible y diversas herramientas de compilación.

Herramientas de compilación

HerramientaVersiones compatiblesDescripción
CMakeVersión 3.25 y posteriores.Necesario para configurar la compilación de Qt. Disponible en Qt Online Installer y en cmake.org.
Ninja-Herramienta recomendada para compilar Qt. Disponible en Qt Online Installer y en ninja-build.org.
PythonVersión 3Herramienta de compilación necesaria. Los instaladores para Windows están disponibles en python.org o en la Tienda de Microsoft.

Los ejecutables cmake.exe, ninja.exe y python.exe deben estar disponibles en tu entorno de compilación. Añade el directorio correspondiente a tu variable de entorno PATH.

Compiladores

Qt 6.12 es compatible con los siguientes compiladores y configuraciones:

Sistema operativoArquitecturaCompiladorNotas
Windows 10 (1809 o posterior)x86_64MSVC 2022, Mingw-w64 15.1
Windows 11x86_64MSVC 2022, Mingw-w64 15.1
Windows en ARMARM64MSVC 2022
Windows en ARMARM64ECMSVC 2026No hay paquetes de instalación.

Falta compatibilidad con algunos módulos de Qt ( WebView, Qt WebEngine y Qt Quick 3D Physics).

Nota: Qt 6.12 será la última versión compatible con Windows 10.

Nota: Para MSVC 2022, se debe seleccionar la versión 10.0.17763 o posterior del SDK de Windows en el instalador de Visual Studio.

Dependencias de QDoc

QDoc utiliza Clang para analizar código C++. Si deseas compilar QDoc manualmente, consulta «Instalación de Clang para QDoc » para conocer los requisitos específicos de compilación.

Qt GRPC y Dependencias de « Qt Protobuf »

Qt GRPC y Qt Protobuf requieren la instalación de los paquetes « gRPC » y « Protobuf ». Puede encontrar las instrucciones de instalación de los paquetes en el «Ejemplo de instalación para Windows con vcpkg».

Configuración del entorno

Para MSVC, realiza una de las siguientes acciones:

  • Ejecute el archivo vcvarsall.bat:
    "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
  • Busca en la barra de búsqueda de Windows el «Símbolo del sistema de VS Native Tools».

Para Mingw-w64: Añade Mingw-w64 a la variable de entorno PATH:

Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%

Paso 3: Compilación de las bibliotecas y herramientas de Qt

Para configurar la compilación, crea un directorio de compilación y ejecuta el script « configure.bat » en dicho directorio:

mkdir C:\dev\qt-build
cd C:\dev\qt-build
C:\dev\Qt\src\configure.bat

Por defecto, Qt está configurado para instalarse en el directorio « C:\Qt\Qt-major.minor.patch », donde la tripleta «major.minor.patch» representa la versión de Qt que se está compilando. Esto se puede cambiar utilizando la opción « -prefix ». Consulta la lista de opciones de configuración de Qt para realizar ajustes adicionales.

A continuación, compila las bibliotecas y las herramientas:

cmake --build . --parallel
# or
ninja

El punto después de « --build » indica la carpeta actual.

Tras la compilación, debes instalar las bibliotecas y herramientas en la ruta deseada (a menos que hayas habilitado una compilación para desarrolladores):

cmake --install .
# or
ninja install

Nota: Para versiones de CMake anteriores a la 4.0, el comando « cmake --install . » solo instala las versiones de lanzamiento de las bibliotecas y herramientas, incluso si se compilan tanto las bibliotecas de depuración como las de lanzamiento. Para instalar ambas, utiliza « ninja install ». También puedes ejecutar los comandos « cmake --install . --config Debug » y « cmake --install . --config Release ».

Paso 4: Compilación de la aplicación

Una vez instalado Qt, puedes empezar a compilar aplicaciones con él.

Si trabajas desde la línea de comandos, plantéate añadir las herramientas de Qt a tu variable de entorno PATH de la siguiente manera:

set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%

Si tiene previsto compilar su aplicación desde un IDE, deberá registrar allí explícitamente la versión de Qt:

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