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

Aprenda a usar apt-cache no Mint, Ubuntu e derivados

Script gerador de senha

Google Chrome para Linux aqui!

Opera 24 Developer no Slackware 14.1

Instalar Freetube no Slackware

Como criar um lançador do Nautilus no painel do Ubuntu

Atalho de teclado para aumentar e diminuir o brilho da tela

Configurando o modem Onda MSA190UP pelo NetworkManager

DIRF 2013 no Wine - Acertando formato da data

Instalar NetKit no Debian Squeeze