Skip to content
PYGWALKER
FAQ
インストールエラー

FAQ: インストールエラー

エラー: quickjs の wheel のビルドに失敗 - Microsoft Visual Studio エラー

よくあるエラーメッセージ

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

影響を受ける環境

  • OS: Windows 10/11
  • Python バージョン: Python 3.7、Python 3.8、Python 3.9
  • インストール方法: pip install pygwalker
  • よく発生するケース: 新規の Python 環境、C++ ビルドツールのない仮想環境

すぐにできる解決策

解決策 1: 事前ビルド済み wheel をインストール（推奨 - コンパイル不要）

pip install --only-binary :all: pygwalker

解決策 2: Python をアップグレード（最も効果的）

# Python 3.9 以上（3.10、3.11、3.12 推奨）にアップグレード
# python.org からダウンロードし、次を実行:
pip install --upgrade pip
pip install pygwalker

解決策 3: Microsoft C++ Build Tools をインストール（Windows ユーザー向け）

  1. Microsoft C++ Build Tools (opens in a new tab) をダウンロード
  2. インストーラーを実行し、"Desktop development with C++" を選択
  3. コマンドプロンプト/ターミナルを再起動
  4. 再度インストールを試す:
pip install pygwalker

代替手段

Anaconda/Miniconda を使用（C 依存関係を自動で処理）

conda install -c conda-forge pygwalker

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

特定のバージョンをインストール（事前ビルド済み wheel あり）

# 事前ビルド済み wheel があるバージョンを確認
pip install pygwalker==0.3.9  # または最新の安定版

Docker を使用（隔離された環境）

FROM python:3.11-slim
RUN pip install pygwalker

このエラーが発生する理由

このエラーが発生するのは次の理由からです:

  1. quickjs は C/C++ のコンパイルを必要とする依存関係である
  2. Windows には標準で C++ コンパイラが含まれていない
  3. Python 3.7 は新しい C++ ビルドツールと互換性の問題がある
  4. パッケージが事前ビルド済みの wheel を使用せず、ソースからビルドしようとしている

インストール後の確認

# pygwalker が正しくインストールされたか確認
import pygwalker as pyg
print(pyg.__version__)

まだ問題がありますか？

上記の解決策がいずれも機能しない場合:

  1. Python のバージョンを確認:

    python --version

    Python 3.8 以上を使用していることを確認してください

  2. pip キャッシュをクリア:

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

  3. 新しい仮想環境で試す:

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

  4. 問題を報告:

検索キーワード

  • pygwalker インストール エラー 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
リソースUse Pygwalker with Streamlit