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)
- Télécharger Microsoft C++ Build Tools (opens in a new tab)
- Exécuter l'installateur et sélectionner "Desktop development with C++"
- Redémarrer l'invite de commande/terminal
- 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 :
- quickjs est une dépendance nécessitant une compilation C/C++
- Windows n'inclut pas de compilateurs C++ par défaut
- Python 3.7 a des problèmes de compatibilité avec les nouveaux outils de compilation C++
- 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 :
-
Vérifiez votre version de Python :
python --version
Assurez-vous d'utiliser Python 3.8 ou supérieur
-
Videz le cache de pip :
pip cache purge pip install --no-cache-dir pygwalker
-
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
-
Signaler le problème :
- GitHub Issues : PyGWalker Issues (opens in a new tab)
- Inclure : version de Python, version de l'OS, journal complet de l'erreur
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