Resolvendo o erro "libQt6Widgets.so.6: cannot open shared object file" no Linux

Quem nunca se deparou com uma mensagem de erro ao tentar executar um programa recém-instalado ou um desenvolvimento próprio, não é mesmo? Uma dessas mensagens comuns, especialmente para aplicações que utilizam interface gráfica com Qt, é:

/usr/local/bin/SeuPrograma: error while loading shared libraries: libQt6Widgets.so.6: cannot open shared object file: No such file or directory

Essa mensagem indica que o seu sistema não conseguiu encontrar a biblioteca compartilhada libQt6Widgets.so.6, essencial para que o programa funcione. Mas não se preocupe, a solução geralmente é simples!

O que é esse arquivo e por que ele não é encontrado?

libQt6Widgets.so.6 é um componente fundamental do Qt 6, mais especificamente do módulo QtWidgets. Bibliotecas compartilhadas (.so - Shared Object) no Linux são como DLLs no Windows: pedaços de código que podem ser usados por múltiplos programas. Se a biblioteca não está instalada ou o sistema não sabe onde encontrá-la, o programa não consegue iniciar.

Como resolver?

A forma mais comum de corrigir esse problema é instalando o pacote que contém a biblioteca libQt6Widgets.so.6. Veja como fazer nas distribuições mais populares:

1. Instale a biblioteca Qt6 Widgets:

Abra seu terminal e utilize o comando correspondente à sua distribuição:

• Para Debian, Ubuntu e derivados (Mint, Pop!_OS, etc.):

  sudo apt update && sudo apt install libqt6widgets6

• Para Fedora:

  sudo dnf install qt6-qtwidgets

• Para Arch Linux e derivados (Manjaro, EndeavourOS, etc.):

  sudo pacman -Syu qt6-widgets

• Para openSUSE:

  sudo zypper install libQt6Widgets6

Observação: Se você não tiver certeza do nome exato do pacote, pode usar o mecanismo de busca do seu gerenciador de pacotes. Por exemplo, no Debian/Ubuntu: apt search qt6 widgets.

2. Atualize o cache das bibliotecas:

Após a instalação, é uma boa prática atualizar o cache das bibliotecas compartilhadas do sistema. Isso garante que o sistema reconheça a nova biblioteca instalada:

sudo ldconfig

3. Teste novamente!

Agora, tente executar seu programa novamente. Na maioria dos casos, o erro já estará resolvido!

Dica adicional

Se o problema persistir, verifique se você possui todas as dependências do Qt6 instaladas. Você pode instalar o pacote completo de desenvolvimento do Qt6 com:

• Debian/Ubuntu: sudo apt install qt6-base-dev
• Fedora: sudo dnf install qt6-qtbase-devel
• Arch: sudo pacman -S qt6-base

Linux Mint 12 RC - baixe agora!

Emerald: Pacotão de temas (Slackware Linux)

Acesso remoto a seu GNU/Linux via linha de comando

Memtest86 USB no Linux

Modo scratchpad no i3wm

Ativando as funcionalidades do gerenciador de janelas Compiz no Linux Mint com ambiente gráfico Mate

Usando várias sessões gráficas no Linux

Interface HY-D-V1 - Instalação no Ubuntu 13.04 e derivadas

Integrando o Yum ao Axel para downloads mais rápidos

Dando - teoricamente - um gás no Gnome-Shell do Arch Linux