En esta página

Qt para Windows - Creación desde el código fuente

Esta página describe el proceso de configuración y construcción de Qt para Windows. Para descargar e instalar un Qt precompilado para Windows, siga las instrucciones de la página Primeros pasos con Qt.

Paso 1: Obtener los fuentes

Las fuentes de Qt pueden instalarse en Qt Online Installer. Los paquetes de fuentes también están disponibles a través de Git, como archivos en la Cuenta Qt (usuarios comerciales), y en download.qt.io (usuarios de código abierto).

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

Si ha descargado el archivo fuente, extráigalo a un directorio de su 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. La ruta también debe ser corta. De este modo se evitan problemas con rutas de archivo demasiado largas en 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 de los fuentes se necesita un entorno de compilación con un compilador compatible y varias herramientas de compilación.

Herramientas de compilación

HerramientaVersiones soportadasDescripción
CMakeVersión 3.22 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 Microsoft Store.

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

Compiladores

Los siguientes compiladores y configuraciones son compatibles con Qt 6.11:

Sistema operativoArquitecturaCompiladorNotas
Windows 10 (1809 o posterior)x86_64MSVC 2022, Mingw-w64 13.1
Windows 11x86_64MSVC 2022, Mingw-w64 13.1
Windows en ARMARM64MSVC 2022

Nota: Actualmente Qt no soporta ARM64EC en Windows en dispositivos ARM.

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

Dependencias de QDoc

QDoc utiliza Clang para analizar el código C++. Si desea compilar QDoc manualmente, consulte Instalación de Clang para QDoc para conocer los requisitos de compilación específicos.

Qt GRPC y Qt Protobuf Dependencias

Qt GRPC y Qt Protobuf requieren la instalación de los paquetes gRPC y Protobuf. Puedes encontrar las instrucciones de instalación de los paquetes en el Ejemplo de instalación para Windows usando vcpkg.

Configuración del entorno

Para MSVC, realice una de las siguientes acciones:

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

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

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

Paso 3: Construir las librerías y herramientas Qt

Para configurar la compilación, cree un directorio de compilación y ejecute el script configure.bat en este 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á construyendo. Esto puede cambiarse utilizando la opción -prefix. Vea la lista de Opciones de Configuración de Qt para hacer más ajustes.

Luego construye las librerías y herramientas:

cmake --build . --parallel
# or
ninja

El punto después de --build significa la carpeta actual.

Después de la construcción, es necesario instalar las bibliotecas y herramientas en la ruta deseada (a menos que haya activado un desarrollador construir):

cmake --install .
# or
ninja install

Nota: Para CMake versión < 4.0. El comando cmake --install . instala sólo las versiones de lanzamiento de las librerías y herramientas incluso si construyes tanto librerías de depuración como de lanzamiento. Para instalar tanto la versión de depuración como la de lanzamiento, utilice ninja install. También puede ejecutar los comandos cmake --install . --config Debug y cmake --install . --config Release.

Paso 4: Construir su aplicación

Una vez instalado Qt, puede empezar a crear aplicaciones con él.

Si trabaja desde la línea de comandos, considere añadir las herramientas Qt a su variable de entorno PATH como se indica a continuación:

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

Si planeas usar Qt desde un IDE, necesitas registrar la versión de Qt explícitamente allí. Para Qt Creator, ver Qt Creator: Añadir versiones 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.