Skip to content
PYGWALKER
FAQ
Erreurs d'installation

FAQ : Erreurs d'installation

ERREUR : Échec de la construction du wheel pour quickjs - erreur Microsoft Visual Studio

Messages d'erreur courants

Les utilisateurs peuvent rencontrer un ou plusieurs de ces messages lors de l'installation de 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

Environnements concernés

  • Système d'exploitation : Windows 10/11
  • Versions de Python : Python 3.7, Python 3.8, Python 3.9
  • Méthode d'installation : pip install pygwalker
  • Fréquent dans : Nouvelles installations de Python, environnements virtuels sans outils de compilation C++

Solutions rapides

Solution 1 : Installer un wheel précompilé (recommandé – aucune compilation nécessaire)

pip install --only-binary :all: pygwalker

Solution 2 : Mettre à niveau Python (la plus efficace)

# Passez à Python 3.9 ou supérieur (3.10, 3.11, 3.12 recommandés)
# Téléchargez depuis python.org, puis :
pip install --upgrade pip
pip install pygwalker

Solution 3 : Installer Microsoft C++ Build Tools (pour les utilisateurs Windows)

  1. Télécharger Microsoft C++ Build Tools (opens in a new tab)
  2. Exécuter l'installateur et sélectionner "Desktop development with C++"
  3. Redémarrer l'invite de commande/terminal
  4. Réessayer l'installation :
pip install pygwalker

Solutions alternatives

Utiliser Anaconda/Miniconda (gère automatiquement les dépendances C)

conda install -c conda-forge pygwalker

Pour les utilisateurs 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

Installer une version spécifique (avec wheels précompilés)

# Vérifier les versions disponibles avec wheels précompilés
pip install pygwalker==0.3.9  # ou la dernière version stable

Solution Docker (environnement isolé)

FROM python:3.11-slim
RUN pip install pygwalker

Pourquoi cette erreur survient

Cette erreur survient parce que :

  1. quickjs est une dépendance nécessitant une compilation C/C++
  2. Windows n'inclut pas de compilateurs C++ par défaut
  3. Python 3.7 a des problèmes de compatibilité avec les nouveaux outils de compilation C++
  4. Le paquet essaie de se construire depuis les sources plutôt que d'utiliser des wheels précompilés

Vérification après l'installation

# Vérifiez si pygwalker est correctement installé
import pygwalker as pyg
print(pyg.__version__)

Vous avez toujours des problèmes ?

Si aucune des solutions ci-dessus ne fonctionne :

  1. Vérifiez votre version de Python :

    python --version

    Assurez-vous d'utiliser Python 3.8 ou supérieur

  2. Videz le cache de pip :

    pip cache purge
    pip install --no-cache-dir pygwalker
  3. Essayez d'installer dans un nouvel environnement virtuel :

    python -m venv fresh_env
    fresh_env\Scripts\activate  # Sous Windows
    # source fresh_env/bin/activate  # Sous Linux/Mac
    pip install --upgrade pip setuptools wheel
    pip install pygwalker
  4. Signaler le problème :

Mots-clés pour la recherche

  • pygwalker erreur d'installation 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