Como instalar a biblioteca Pillow (PIL) no QGIS e resolver outros erros Python de importação em plugins

Durante a instalação do QGIS, seja no macOS, Linux ou Windows, é comum que o ambiente Python interno não venha com todas as bibliotecas que utilizamos no dia a dia.

Isso pode gerar erros ao utilizar plugins mais avançados, como o LFTools.

Um exemplo recorrente, especialmente em algumas versões do QGIS no macOS, é o erro relacionado às bibliotecas Pillow (PIL) e matplotlib ao executar ferramentas como a geração de Memorial Descritivo, que pode apresentar mensagens como a mostrada abaixo:

Por que esse erro acontece?

O QGIS utiliza um Python embarcado (isolado). Isso significa que:

👉 Bibliotecas Python instaladas no sistema não são reconhecidas automaticamente pelo QGIS

Ou seja, mesmo que você já tenha o Pillow instalado no seu computador em outro ambiente, o QGIS pode não encontrá-lo.

🔍 Como verificar se o Pillow está instalado no QGIS

Abra o Console Python do QGIS e execute:

from PIL import Image

✔️ Resultado esperado:

• Se não aparecer erro → tudo certo
• Se aparecer algo como:

ModuleNotFoundError: No module named ‘PIL’

👉 Nesse caso, será necessário instalar a biblioteca.

⚙️ Como instalar o Pillow dentro do QGIS

Você pode fazer isso diretamente no ambiente do QGIS (principalmente em macOS e Linux).

✅ Método 1 — Usando pip (testado no macOS)

No Console Python do QGIS:

import pip

pip.main(["install", "Pillow"])

⚠️ Método 2 (alternativo) — Usando subprocess (Linux)

No Console Python do QGIS:

import subprocess
import sys

subprocess.run([sys.executable, "-m", "pip", "install", "Pillow"])

🖥️ Instalação pelo OSGeo4W Shell (Windows)

No Windows, você também pode instalar pelo terminal do QGIS (OSGeo4W Shell).
Recomenda-se abrir como administrador.

Execute um dos comandos abaixo:

pip install Pillow

Ou, de forma mais segura:

python -m pip install Pillow

⚠️ Observação importante sobre os métodos de instalação

Na prática, a instalação utilizando diretamente o pip tem apresentado melhores resultados, especialmente em ambientes macOS e Windows.

Durante os testes realizados, esse método se mostrou mais estável e confiável para instalar bibliotecas no ambiente do QGIS.

Já a abordagem utilizando subprocess, embora tecnicamente correta, pode causar instabilidades em alguns casos — inclusive travamentos do QGIS durante a execução. Por esse motivo, recomenda-se utilizá-la apenas como alternativa, caso o método com pip não funcione.

📦 E quanto ao matplotlib?

Outra biblioteca que pode faltar em algumas instalações (principalmente no macOS) é o matplotlib.

Caso apareça o erro:

ModuleNotFoundError: No module named ‘matplotlib’

Você pode instalar utilizando os mesmos métodos:

🔹 Via pip no Python:

import pip
pip.main(["install", "matplotlib"])

🔹 Via subprocess:

import subprocess
import sys

subprocess.run([sys.executable, "-m", "pip", "install", "matplotlib"])

🔹 Ou pelo terminal (OSGeo4W):

pip install matplotlib

🎯 Conclusão

Problemas com bibliotecas Python no QGIS são mais comuns do que parecem — principalmente por conta do seu ambiente isolado.

A boa notícia é que a solução é simples:

✔️ Identificar o erro
✔️ Testar o import
✔️ Instalar via pip no ambiente correto

💬 E você?

Se esse procedimento resolveu o seu problema, deixe seu feedback!
Esse tipo de dúvida é muito comum e compartilhar soluções ajuda toda a comunidade Geo 🚀

🚀 Quer ir além? Aprenda Python para QGIS com suporte especializado

Se você deseja evoluir no desenvolvimento com Python aplicado ao Geoprocessamento e à Topografia no QGIS, vale a pena conhecer o curso da GeoOne:

No curso, você vai aprender:

• Automatização de processos no QGIS com Python
• Desenvolvimento de plugins (como o próprio LFTools)
• Manipulação de dados vetoriais e raster
• Integração com bancos de dados espaciais
• Boas práticas para desenvolvimento profissional

💡 Além disso, você conta com dicas práticas, suporte especializado e acompanhamento, acelerando sua evolução no uso de Python para aplicações reais.

👉 INSCREVA-SE HOJE MESMO!