Pythonライブラリのインストール時に「error: Microsoft Visual C++ 14.0 or greater is required.」というエラーが発生し、C拡張モジュールのビルドに失敗する現象が起きました。これは、システム内に対応するバイナリ(Wheel)が存在せず、ソースからコンパイルしようとした際にC++コンパイラが不足していることが原因です。
何が起きたか(発生した症状と原因)
-
pip install実行時にC拡張モジュールを含むパッケージのビルドが失敗する - エラーメッセージに「Microsoft Visual C++ 14.0 or greater is required」が表示される
- PyPIにコンパイル済みのバイナリ(
.whl)がない環境で、ローカルからのコンパイルが必要になるため
どう解決したか(基本手順とコマンド)
Visual Studio Installerから「C++によるデスクトップ開発」ワークロードを導入し、Windows SDKとC++ビルドツールを有効にします。
vs_buildtools.exe --norestart --passive --downloadThenInstall --includeRecommended --add Microsoft.VisualStudio.Workload.NativeDesktop
👉 インストールサイズを抑えるための非公式Wheelの活用法や、Pythonダウングレードという代替案のメリット・デメリットについては、元記事で詳しく解説しています。
「C++ .以上が必要です」エラー徹底解説!Pythonパッケージインストール時の救世主「C++ Build Tools」
対策後の効果(Before / After)
-
Before:
pip installのたびにコンパイルエラーで止まり、最新のライブラリや機械学習パッケージの導入ができない状態 - After: C++ Build Toolsの導入により、C拡張を含むパッケージもスムーズにインストール可能になり、環境構築で迷わなくなる
🚀 完全なコード・環境別の詳細手順はこちら
GUIの具体的な選択画面、コマンドラインによる自動インストール手順、さらに「インストール済みなのにエラーが消えない」場合のトラブルシュートをまとめています。
👉 「C++ .以上が必要です」エラー徹底解説!Pythonパッケージインストール時の救世主「C++ Build Tools」
※本記事は技術ブログ CodeArchPedia.com の執筆記事から要点を抜粋した技術ノートです。