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

Modem ZTE mf645 no Linux sem aperreio

Nova versão do jogo Sauerbraten (FPS) 2013

fish shell no Slackware

Ganhando espaço no Firefox

Recuperando tela de login no Ubuntu

Adicionando repositório no SuSE

Configuração de rede no CentOS

Resolvendo o problema de autenticação no wvdial

O que fazer após instalar Fedora 28 Workstattion

Configuração de acentos no KDE 4.4 do Kubuntu 9.10