Qt para Linux: compilación a partir del código fuente
Esta página describe cómo configurar y compilar Qt para Linux a partir del código fuente. Ten en cuenta que, por lo general, resulta más sencillo instalar las bibliotecas y herramientas de Qt ya compiladas a través de Qt Online Installer. Muchas distribuciones de Linux también ofrecen paquetes de Qt a través de su gestor de paquetes. No obstante, compila Qt a partir del código fuente si deseas personalizarlo aún más o si utilizas una distribución para la que no hay disponibles paquetes binarios de Qt (en la versión adecuada).
Los responsables de los paquetes de las distribuciones pueden encontrar más información sobre cómo empaquetar Qt en las recomendaciones de empaquetado.
Paso 1: Obtener el código fuente
Los códigos fuente de Qt se pueden instalar 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 (usuarios comerciales) y en download.qt.io (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, $HOME/Qt/6.12.0/Src.
Si has descargado el archivo único de código fuente, extráelo en el directorio que prefieras:
cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.12.0.tar.xzPaso 2: Instalar los requisitos de compilación
Para compilar Qt se necesita un entorno de compilación con herramientas, compiladores y paquetes de desarrollo.
Herramientas de compilación
| Herramienta | Versiones compatibles |
|---|---|
| CMake | Versión 3.25 y posteriores. |
| Ninja | - |
| Python | Versión 3 |
Nota: configure siempre utiliza el generador y la herramienta de compilación Ninja si hay disponible un ejecutable ninja. Ninja es multiplataforma, cuenta con numerosas funciones, ofrece un buen rendimiento y se recomienda en todas las plataformas. El uso de otros generadores podría funcionar, pero no cuenta con soporte oficial.
Compiladores y paquetes de desarrollo
Qt 6.12 es compatible con los siguientes compiladores y configuraciones:
| Distribución | Arquitectura | Compilador | Notas |
|---|---|---|---|
| Red Hat™ 9.6 | x86_64 | GCC 11 | |
| Red Hat 10.0 | x86_64 | GCC 14 | |
| openSUSE 16.0 | x86_64 | GCC 15 | |
| SUSE Linux Enterprise Server 15 SP6 | x86_64 | GCC 11 | |
| Ubuntu 22.04 | x86_64 | GCC tal y como lo proporciona Canonical, GCC 11.x | Véase también: Paquetes Enterprise Qt para Debian. |
| Ubuntu 24.04 | x86_64, arm64 | GCC proporcionado por Canonical, GCC 13.x | Consulta la nota sobre la compatibilidad con Linux en equipos de sobremesa con procesadores Arm. |
| Debian 11.6 | x86_64, arm64 | GCC 10 | Consulta la nota sobre la compatibilidad de Linux en ordenadores de sobremesa con procesadores Arm. |
| Debian 12 | x86_64, arm64 | GCC 12 | Véase también: Paquetes Debian de Enterprise Qt. Consulte la nota sobre la compatibilidad de Linux en equipos de escritorio con procesadores ARM. |
Nota: Para Linux en Arm en ordenadores de sobremesa, utilizamos una Raspberry Pi 5 con 8 GB de RAM y Ubuntu 24.04 como plataforma de referencia. Si tienes algún problema con otro hardware, intenta reproducir el problema en una Raspberry Pi 5. Tenemos previsto pasar a ofrecer soporte para una gama más amplia de hardware de escritorio basado en ARM cuando esté disponible. Los binarios oficiales de Qt Online Installer se compilan en Ubuntu 24.04, que incluye glibc 2.39; si tu versión de glibc es anterior a la que utilizamos para la compilación, deberás recompilar a partir del código fuente.
Es posible que otros compiladores y configuraciones funcionen, pero no se han probado de forma activa.
Qt también depende de la disponibilidad de diversas bibliotecas y paquetes de desarrollo, que normalmente se instalan mediante el gestor de paquetes de la resolución correspondiente. Consulta Qt para Linux - Requisitos para obtener más detalles.
Paso 3: Compilar las bibliotecas y herramientas de Qt
Para configurar la compilación, crea un directorio de compilación y ejecuta el script « ./configure » en dicho directorio:
mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.12.0/configurePor defecto, Qt está configurado para instalarse en el directorio /usr/local/Qt-6.12.0. Esto se puede cambiar utilizando la opción -prefix. Consulta la lista de opciones de configuración para realizar más ajustes.
¿Se ha ejecutado correctamente « configure »? En ese caso, continúa con la compilación de las bibliotecas y las herramientas:
cmake --build . --parallelTras la compilación, debes instalar las bibliotecas y herramientas en la ubicación adecuada (a menos que hayas habilitado una compilación para desarrolladores):
cmake --install .Ten en cuenta que esto puede requerir acceso de root.
Paso 4: Compilación de la aplicación
Una vez instalado Qt, ya puedes empezar a crear aplicaciones con él.
Si trabajas desde la línea de comandos, plantéate añadir las herramientas de Qt a tu directorio predeterminado PATH. Para ello, sigue estos pasos:
En el archivo .profile (si tu shell es bash, ksh, zsh o sh), añade las siguientes líneas:
PATH=/usr/local/Qt-6.12.0/bin:$PATH
export PATHEn el archivo ` .login ` (si tu shell es `csh` o `tcsh`), añade la siguiente línea:
setenv PATH /usr/local/Qt-6.12.0/bin:$PATHSi tienes pensado compilar tu aplicación desde un IDE, debes registrar allí explícitamente la versión de Qt:
- Para Qt Creator, consulta Qt Creator: Añadir versiones de Qt.
- Para Qt Extension for Visual Studio Code, consulta Qt Extension for Visual Studio Code: Registrar instalaciones 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.