Como resolver: fatal error: Python.h: No such file or directory
Neste artigo você vai aprender a como resolver o fatal error: Python.h: No such file or directory, de uma maneira simples e eficaz!

Fala programador(a), beleza? Bora aprender mais sobre Python e também a como resolver um fatal error!
Este erro ocorre pela falta de um pacote no sistema operacional, precisamos utilizar o gerenciador de pacotes para instalá-lo
Formação Claude Code
Domine Claude Code do absoluto zero até o avançado
- 120 aulas
- 4 projetos
- 9h 45min
Neste exemplo vou partir da distribuição Ubuntu, você vai precisar adaptar ao seu gerenciador de pacotes
E o que falta na nossa máquina é o pacote python-dev, que pode variar dependendo da versão de Python que você utiliza (2 ou 3)
Veja então como fazer a instalação nas duas versões:
sudo apt-get install python-dev # Para Python 2 sudo apt-get install python3-dev # Para Python 3
Após este comando seu computador contará com um pacteo que tem como função ler arquivos e bibliotecas de Python
E agora o erro não deve mais persistir no seu software, tente novamente e veja se foi solucionado o problema
Caso ainda ocorra, veja qual a versão exata de Python instalada em sua máquina, com o comando:
import sys
print("Python version")
print (sys.version)
E se veja qual o número após o início 3.X, onde X é algum número da versão menor
E instale o seguinte pacote, dependendo da versão instalada:
sudo apt install libpython3.8-dev
Supondo que a versão seja 3.8, mude o 8 para a versão correspondente do seu sistema e tente novamente a execução do seu software
Conclusão
Neste artigo você aprender a como resolver o erro fatal: Python.h: No such file or directory
Instalamos dois pacotes diferentes, dependendo da versão de Python está em execução na sua máquina
E por fim, foi apresentada uma outra solução para a versão 3 de Python, com a instalação do pacote libpython
Com a utilização das duas abordagens o seu software deve agora estar funcionando, estas são as soluções com mais chances de êxito para resolver o problema
Confira também nosso catálogo de cursos gratuitos, com aulas semanais no YouTube
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 27min
Blog | Mais populares

Como limitar números decimais em Python?
Adicionar uma seção sobre f-strings, o jeito mais usado hoje pra formatar casa decimal. Exemplo: valor = 3.14159 e print(f"{valor:.2f}") mostrando 3.14. Explicar que o […]
Como programar Python [dicas e códigos iniciantes aqui]
Python é uma linguagem de programação muito popular e uma de alto nível utilizada em diferentes tipos de aplicações, como para o desenvolvimento web, em Machine […]

Como inverter uma string em Python
Neste artigo você vai aprender a como inverter uma string em Python, de uma maneira simples para você utilizar em seus programas Conteúdo também disponível […]
