Pythonの「Microsoft Visual C++ 14.0 or greater is required」エラーの解決方法

問題：大量の赤いエラーメッセージ単純な pip install を実行し、数秒で終わることを期待していると、mysqlclient や pandas、pycocotools といったパッケージの「Building Wheel」中に、ターミナルが真っ赤なエラーメッセージで埋め尽くされることがあります。その一番下に、原因が隠れています。

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/downloads/

これは通常、クリーンインストール直後の Windows で発生します。単に、C++ コードをコンピュータが実際に実行できる形式に変換するためのツールがシステムに不足していることを意味します。

なぜ Python に C++ ツールが必要なのかすべての Python ライブラリが Python だけで書かれているわけではありません。パフォーマンスを高く保つために、多くの高性能ライブラリは内部で C や C++ を使用しています。これらをインストールする際、pip は「wheel」（すぐに使用可能なコンパイル済みファイル）を探します。

特定の Python バージョンや OS 用のコンパイル済み wheel が利用できない場合、pip はライブラリをゼロからビルドしようとします。そのためには、Microsoft Visual C++ (MSVC) コンパイラが必要です。これがないと、コンピュータがライブラリのソースコードを読み取る方法を知らないため、インストールが失敗します。

まず試すべきこと：Setup Tools のアップグレード数ギガバイトのソフトウェアをダウンロードする前に、コアパッケージツールの更新を試してください。最新の wheel は常に PyPI に追加されています。古いバージョンの pip では、必要なコンパイル済みバージョンが見つからない場合があります。

python -m pip install --upgrade pip setuptools wheel

これを実行した後、再度インストールを試してください。それでも失敗する場合は、確実にコンパイラツールが必要です。

根本的な解決策：Microsoft C++ Build Tools のインストール20GB ものディスク容量を消費するフル機能の Visual Studio IDE は必要ありません。スタンドアロンの Build Tools だけで十分です。これはダウンロードサイズが約 1.5GB で、インストール後はディスク上で約 4.5GB になります。

1. インストーラーのダウンロードMicrosoft C++ Build Tools のページにアクセスします。「Build Tools のダウンロード」をクリックして、vs_buildtools.exe ファイルを取得します。

2. 正しいコンポーネントの選択ここが最も重要な部分です。インストーラーを実行するだけでは不十分で、何をインストールするかを指示する必要があります。

• ダウンロードした Visual Studio Installer を開きます。- Build Tools のカードにある「インストール」（または「変更」）をクリックします。- 「ワークロード」タブで、「C++ によるデスクトップ開発」にチェックを入れます。- 右側の「インストールの詳細」で、以下がチェックされていることを確認します。MSVC v143 - VS 2022 C++ x64/x86 ビルド ツール (最新)- Windows 10 SDK (最新の OS を使用している場合は Windows 11 SDK)### 3. インストールと再起動「インストール」ボタンをクリックします。プロセスが 100% になったら、コンピュータを再起動してください。Windows がシステム環境内の新しいコンパイラパスを認識するために、この再起動が必要です。

修正のテスト新しいターミナル（コマンドプロンプトまたは PowerShell）を開き、再度インストールを試してください。例：

pip install mysqlclient

「Building wheel for mysqlclient」に続いて「Successfully installed」というメッセージが表示されるはずです。赤いテキストは消えているはずです。

よくある問題のトラブルシューティング### 「cl.exe」の問題エラーが解消されない場合、pip が依然としてコンパイラを見つけられない可能性があります。スタートメニューで「Developer Command Prompt for VS」を検索してください。その専用ウィンドウ内で pip install コマンドを実行します。この環境は、C++ コンパイラへの必要なパスがすべて事前に設定されています。

Conda という選択肢Anaconda や Miniconda を使用している場合は、C++ の問題を完全に回避できることがよくあります。Conda は独自のコンパイル済みバイナリエコシステムを使用しています。代わりに以下を試してください。

conda install -c conda-forge <package-name>

まとめ「Visual C++ 14.0」エラーは、Python コードのバグではありません。Python と Windows オペレーティングシステムの間の「架け橋」が欠けているだけです。「C++ によるデスクトップ開発」ワークロードをインストールすることで、今後遭遇するほぼすべての複雑な Python ライブラリを処理できる環境が整います。