Skip to content
Tutoriais
Matplotlib
Facing 'No Module Named Matplotlib' Error? Here is the Solution

Como Resolver o Erro 'No Módulo Chamado Matplotlib'

Lá está você, saboreando seu café recém-preparado, pronto para mais um dia de programação em Python, quando de repente, seu código para e exibe o temido erro 'No Módulo Chamado Matplotlib'. Em vez de permitir que isso arruíne seu dia, vamos mergulhar fundo no que esse erro significa, por que ele ocorre e como resolvê-lo.

Mas lembre-se, no grande esquema da programação, esses obstáculos são apenas pedras no caminho para nos tornarmos programadores melhores. Então, vamos conquistar esse erro juntos e, no processo, nos tornarmos Pythonistas mais habilidosos!

Compreendendo o Erro 'No Módulo Chamado Matplotlib'

Antes de irmos às soluções, é crucial entender por que esse erro ocorre. Como o nome sugere, o erro 'No Módulo Chamado Matplotlib' ocorre quando o Python não consegue localizar o módulo Matplotlib. As razões podem variar desde o módulo não estar instalado, o Python verificar o local errado, versões diferentes do Python causando confusão até o uso do comando incorreto para executar o script.

Vamos analisar esses problemas e explorar suas soluções:

Problema 1: Matplotlib Não Está Instalado

Uma das principais razões para o surgimento do erro 'No Módulo Chamado Matplotlib' é a ausência da própria biblioteca Matplotlib. É tão simples como parece - se a biblioteca não estiver instalada, o Python não conseguirá encontrá-la.

Solução: Instalar o Matplotlib

Para instalar o Matplotlib, você pode usar o pip, o instalador de pacotes padrão do Python. No seu terminal, digite:

pip install matplotlib

Para usuários do Python3, o comando é ligeiramente diferente:

pip3 install matplotlib

Esse comando simples faz o pip buscar a biblioteca do Matplotlib no PyPi (Índice de Pacotes do Python) e instalá-la em seu ambiente Python.

Problema 2: Múltiplas Versões do Python

Outra causa comum desse erro é a existência de múltiplas versões do Python em sua máquina. Você pode ter o Matplotlib instalado para o Python2, mas está tentando importá-lo usando o Python3, ou vice-versa.

Solução: Alinhar as Versões do Python e do Matplotlib

Primeiro, verifique qual versão do Python você está usando. No seu terminal, digite:

python --version

Para Python3:

python3 --version

Dependendo da sua versão do Python, verifique se está instalando o Matplotlib para a versão correspondente do Python.

Executando Scripts Python: Hashbang para o Resgate

Agora, vamos discutir um cenário mencionado no exemplo que inspirou este artigo. O usuário conseguiu executar seu script usando python ./plot_test.py com sucesso, mas encontrou o erro 'No Módulo Chamado Matplotlib' ao executar ./plot_test.py.

A diferença está na forma como esses dois comandos funcionam. Quando você usa explicitamente python ou python3 antes do seu script, ele usará o interpretador Python que você especificou (python2 ou python3). No entanto, ao tentar executar o script como ./plot_test.py, seu sistema verifica o 'hashbang' (#!) no início do script para determinar qual interpretador usar.

Se o seu hashbang for #!/usr/bin/python, ele usará o Python2. No entanto, se for #!/usr/bin/env python3, ele usará o Python3. O desalinhamento entre a versão do Python e a versão para a qual o Matplotlib está instalado pode levar ao nosso famoso erro 'No Módulo Chamado Matplotlib'.

Solução: Corrigir o Hashbang

Para evitar esse problema, verifique se o seu hashbang corresponde à versão do Python para a qual o Matplotlib está instalado. Se estiver instalado para o Python2, use #!/usr/bin/python. Se for para o Python3, use #!/usr/bin/env python3.

Continuando nossa exploração, vamos aprofundar em cenários mais complexos que podem levar ao erro 'No Módulo Chamado Matplotlib'. Também responderemos a algumas perguntas frequentes sobre esse erro no final do artigo.

Problema 3: Python Verificando o Local Errado

O Python, ao procurar módulos instalados, procura em diretórios específicos definidos em seu PATH. Se o seu módulo Matplotlib estiver instalado em um local que não é incluído no PATH, o Python não conseguirá encontrá-lo, resultando em nosso erro.

Solução: Adicionar o Caminho do Matplotlib ao PATH do Python

Você pode usar o módulo sys para adicionar o caminho onde o Matplotlib está instalado ao PATH do Python. Aqui está um pequeno trecho de código para ilustrar como fazer isso:

import sys
sys.path.append('caminho_do_matplotlib')

Substitua 'caminho_do_matplotlib' pelo caminho real da sua instalação do Matplotlib.

Problema 4: Instalação Corrompida ou Incompleta do Matplotlib

Às vezes, uma instalação corrompida ou incompleta do Matplotlib pode causar o erro 'No Módulo Chamado Matplotlib'. Isso pode ocorrer devido a um processo de instalação com falhas, problemas de rede durante a instalação ou falhas do sistema.

Solução: Reinstalar o Matplotlib

Nesse caso, é melhor desinstalar o Matplotlib e, em seguida, reinstalá-lo. Você pode desinstalar usando o comando pip uninstall e reinstalá-lo como discutido anteriormente.

pip uninstall matplotlib
pip install matplotlib

Substitua pip por pip3 se estiver usando o Python3.

Alternativa ao Matplotlib: Visualize Dados com o PyGWalker

Além de usar o Matplotlib para visualizar o seu dataframe do pandas, aqui está uma alternativa, uma biblioteca Python de código aberto que pode ajudar você a criar visualizações de dados com facilidade: PyGWalker (opens in a new tab).

PyGWalker para Visualização de Dados (opens in a new tab) Não é mais necessário realizar processamentos complicados com codificação em Python, simplesmente importe seus dados e arraste e solte variáveis para criar todos os tipos de visualizações de dados! Aqui está um vídeo de demonstração rápida sobre a operação:


Veja como usar o PyGWalker no seu Jupyter Notebook:

pip install pygwalker
import pygwalker as pyg
gwalker = pyg.walk(df)

Alternativamente, você pode testá-lo no Kaggle Notebook/Google Colab:

Execute o PyGWalker no Kaggle Notebook (opens in a new tab)Execute o PyGWalker no Google Colab (opens in a new tab)Dê uma ⭐️ ao PyGWalker no GitHub (opens in a new tab)
Execute o PyGWalker no Kaggle Notebook (opens in a new tab)Execute o PyGWalker no Google Colab (opens in a new tab)Execute o PyGWalker no Google Colab (opens in a new tab)

O PyGWalker é construído com o apoio da nossa comunidade de código aberto. Não se esqueça de conferir o PyGWalker GitHub (opens in a new tab) e dar uma estrela para nós!

Seção de Perguntas Frequentes

  1. Por que estou encontrando o erro 'No Module Named Matplotlib' mesmo após uma instalação bem-sucedida?

É possível que você esteja tentando executar o script usando uma versão diferente do Python para a qual o Matplotlib está instalado. Verifique a versão do Python e certifique-se de que ela esteja alinhada com a instalação do Matplotlib.

  1. Por que o erro persiste mesmo após corrigir a versão do Python?

Isso pode acontecer devido a uma instalação corrompida ou incompleta do Matplotlib, ou o Python pode estar verificando o local errado para os módulos instalados. Você pode tentar reinstalar o Matplotlib ou adicionar o caminho do Matplotlib ao PATH do Python.

  1. Posso evitar o erro 'No Module Named Matplotlib' instalando o Matplotlib em um diretório específico?

O Python procura módulos instalados em diretórios específicos definidos em seu PATH. Enquanto o diretório onde o Matplotlib está instalado estiver incluído no PATH do Python, o Python deve ser capaz de encontrá-lo.