Skip to content
PYGWALKER
FAQ
Erros de instalação

FAQ: Erros de instalação

ERRO: Falha ao construir o wheel para quickjs - erro do Microsoft Visual Studio

Mensagens de erro comuns

Os usuários podem encontrar uma ou mais destas mensagens ao instalar o PyGWalker:

  • ERROR: Failed building wheel for quickjs
  • error: Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.42.34433\bin\HostX86\x64\cl.exe' failed with exit code 2
  • error D8024 : incompatible-pointer-types
  • [end of output] note: This error originates from a subprocess, and is likely not a problem with pip
  • ERROR: Could not build wheels for quickjs, which is required to install pyproject.toml-based projects
  • Building wheel for quickjs (setup.py) ... error
  • error: Microsoft C++ 14.0 or greater is required

Ambientes afetados

  • Sistema operacional: Windows 10/11
  • Versões do Python: Python 3.7, Python 3.8, Python 3.9
  • Método de instalação: pip install pygwalker
  • Comum em: Instalações novas de Python, ambientes virtuais sem ferramentas de compilação C++

Soluções rápidas

Solução 1: Instalar wheel pré-compilado (Recomendado - sem necessidade de compilação)

pip install --only-binary :all: pygwalker

Solução 2: Atualizar o Python (Mais eficaz)

# Atualize para Python 3.9 ou superior (3.10, 3.11, 3.12 recomendados)
# Faça o download em python.org e depois:
pip install --upgrade pip
pip install pygwalker

Solução 3: Instalar Microsoft C++ Build Tools (Para usuários Windows)

  1. Baixe Microsoft C++ Build Tools (opens in a new tab)
  2. Execute o instalador e selecione "Desktop development with C++"
  3. Reinicie o prompt de comando/terminal
  4. Tente instalar novamente:
pip install pygwalker

Soluções alternativas

Usar Anaconda/Miniconda (lida automaticamente com dependências C)

conda install -c conda-forge pygwalker

Para usuários WSL/Linux

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install python3-dev build-essential
pip install pygwalker
 
# CentOS/RHEL/Fedora
sudo yum install python3-devel gcc gcc-c++
pip install pygwalker

Instalar versão específica (com wheels pré-compilados)

# Verifique as versões disponíveis com wheels pré-compilados
pip install pygwalker==0.3.9  # ou a versão estável mais recente

Solução com Docker (Ambiente isolado)

FROM python:3.11-slim
RUN pip install pygwalker

Por que esse erro ocorre

Esse erro ocorre porque:

  1. quickjs é uma dependência que requer compilação em C/C++
  2. O Windows não inclui compiladores C++ por padrão
  3. O Python 3.7 possui problemas de compatibilidade com ferramentas de compilação C++ mais novas
  4. O pacote tenta compilar a partir do código-fonte em vez de usar wheels pré-compilados

Verificação após a instalação

# Teste se o pygwalker foi instalado corretamente
import pygwalker as pyg
print(pyg.__version__)

Ainda com problemas?

Se nenhuma das soluções acima funcionar:

  1. Verifique a versão do Python:

    python --version

    Certifique-se de que está usando Python 3.8 ou superior

  2. Limpe o cache do pip:

    pip cache purge
pip install --no-cache-dir pygwalker

  3. Tente instalar em um novo ambiente virtual:

    python -m venv fresh_env
fresh_env\Scripts\activate  # No Windows
# source fresh_env/bin/activate  # No Linux/Mac
pip install --upgrade pip setuptools wheel
pip install pygwalker

  4. Relate o problema:

Palavras-chave para pesquisa

  • pygwalker erro de instalação windows
  • failed building wheel for quickjs pygwalker
  • pygwalker microsoft visual studio error
  • pygwalker cl.exe failed with exit code 2
  • pygwalker incompatible-pointer-types error
  • pip install pygwalker error quickjs
  • pygwalker setup.py error
  • pygwalker C++ 14.0 required error
  • cannot install pygwalker windows
  • pygwalker build wheels failed
RecursosComo usar PyGWalker com Streamlit