FAQ: Installationsfehler

FEHLER: Aufbau des Wheels für quickjs fehlgeschlagen – Microsoft Visual Studio Fehler

Häufige Fehlermeldungen

Beim Installieren von PyGWalker können Nutzer eine oder mehrere der folgenden Fehlermeldungen sehen:

• 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

Betroffene Umgebungen

• Betriebssystem: Windows 10/11
• Python-Versionen: Python 3.7, Python 3.8, Python 3.9
• Installationsmethode: pip install pygwalker
• Häufig bei: Frischen Python-Installationen, virtuellen Umgebungen ohne C++ Build-Tools

Schnelllösungen

Lösung 1: Vorgefertigtes Wheel installieren (Empfohlen – keine Kompilierung nötig)

pip install --only-binary :all: pygwalker

Lösung 2: Python aktualisieren (Am effektivsten)

# Upgrade auf Python 3.9 oder höher (3.10, 3.11, 3.12 empfohlen)
# Download von python.org, dann:
pip install --upgrade pip
pip install pygwalker

Lösung 3: Microsoft C++ Build Tools installieren (Für Windows-Nutzer)

1. Microsoft C++ Build Tools (opens in a new tab) herunterladen
2. Installer ausführen und "Desktop development with C++" auswählen
3. Eingabeaufforderung/Terminal neu starten
4. Erneut versuchen:

pip install pygwalker

Alternative Lösungen

Anaconda/Miniconda verwenden (verwaltet C-Abhängigkeiten automatisch)

conda install -c conda-forge pygwalker

Für WSL/Linux-Nutzer

# 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

Spezifische Version installieren (mit vorgefertigten Wheels)

# Verfügbare Versionen mit vorgefertigten Wheels prüfen
pip install pygwalker==0.3.9  # oder neueste stabile Version

Docker-Lösung (isolierte Umgebung)

FROM python:3.11-slim
RUN pip install pygwalker

Warum tritt dieser Fehler auf

Dieser Fehler tritt auf, weil:

1. quickjs eine Abhängigkeit ist, die C/C++-Kompilierung benötigt
2. Windows standardmäßig keine C++-Compiler enthält
3. Python 3.7 Kompatibilitätsprobleme mit neueren C++ Build Tools hat
4. Das Paket versucht, aus dem Quellcode statt über vorgefertigte Wheels zu installieren

Überprüfung nach der Installation

# Testen, ob pygwalker korrekt installiert wurde
import pygwalker as pyg
print(pyg.__version__)

Noch Probleme?

Wenn keine der oben genannten Lösungen hilft:

1. Python-Version prüfen:

   python --version

   Stelle sicher, dass Python 3.8 oder höher verwendet wird

2. pip-Cache leeren:

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

3. In einer neuen virtuellen Umgebung installieren:

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

4. Problem melden:

   • GitHub-Issues: PyGWalker Issues (opens in a new tab)
   • Füge hinzu: Python-Version, OS-Version, vollständiges Fehlerprotokoll

Suchbegriffe

• pygwalker Installationsfehler 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