概要

pipでパッケージをインストールする際にC拡張のビルドに失敗するエラーです。

エラーメッセージ

``` error: Microsoft Visual C++ 14.0 or greater is required. ```

または

``` error: command ‘gcc’ failed with exit status 1 ```

原因

1. ビルドツールの不足: gcc, make等がない
2. 開発ヘッダの不足: python-dev等がない
3. ライブラリの不足: 依存するCライブラリがない
4. wheelの未提供: プリビルドバイナリがないプラットフォーム

解決策

1. ビルドツールをインストール

```bash

Ubuntu/Debian

sudo apt-get install build-essential python3-dev

CentOS/RHEL

sudo yum groupinstall “Development Tools” sudo yum install python3-devel

macOS

xcode-select –install

Windows

Visual Studio Build Tools をインストール

https://visualstudio.microsoft.com/visual-cpp-build-tools/

```

2. 依存ライブラリをインストール

```bash

例: psycopg2 (PostgreSQL)

sudo apt-get install libpq-dev

例: mysqlclient

sudo apt-get install default-libmysqlclient-dev

例: Pillow

sudo apt-get install libjpeg-dev zlib1g-dev

例: lxml

sudo apt-get install libxml2-dev libxslt1-dev ```

3. バイナリ版を使用

```bash

psycopg2 の代わりにバイナリ版

pip install psycopg2-binary

numpy, scipy 等はwheelが提供される

pip install numpy ```

4. 古いバージョンを試す

```bash

特定バージョンを指定

pip install package==1.2.3

wheelが提供されているバージョンを探す

pip install package –prefer-binary ```

5. pip を最新化

```bash pip install –upgrade pip setuptools wheel ```

6. 仮想環境を使用

```bash

venv を作成

python -m venv venv source venv/bin/activate

必要なツールを最新化

pip install –upgrade pip setuptools wheel pip install package ```

よくある間違い

• システムPythonに直接インストール
• 開発用ヘッダファイルを入れ忘れる
• Windows で Visual Studio が必要と知らない

関連エラー

• pip: Could not find
• Python: ModuleNotFoundError