En esta página

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

Paso 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

HerramientaVersiones compatibles
CMakeVersión 3.25 y posteriores.
Ninja-
PythonVersió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ónArquitecturaCompiladorNotas
Red Hat™ 9.6x86_64GCC 11
Red Hat 10.0x86_64GCC 14
openSUSE 16.0x86_64GCC 15
SUSE Linux Enterprise Server 15 SP6x86_64GCC 11
Ubuntu 22.04x86_64GCC tal y como lo proporciona Canonical, GCC 11.xVéase también: Paquetes Enterprise Qt para Debian.
Ubuntu 24.04x86_64, arm64GCC proporcionado por Canonical, GCC 13.xConsulta la nota sobre la compatibilidad con Linux en equipos de sobremesa con procesadores Arm.
Debian 11.6x86_64, arm64GCC 10Consulta la nota sobre la compatibilidad de Linux en ordenadores de sobremesa con procesadores Arm.
Debian 12x86_64, arm64GCC 12Vé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/configure

Por 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 . --parallel

Tras 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 PATH

En 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:$PATH

Si tienes pensado compilar tu aplicación desde un IDE, debes 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.