冒頭まとめ

WindowsでPythonのパッケージを入れる途中に、次のエラーが出ることがあります。

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

setuptoolsが、CやC++のコードを組み立てるためのMicrosoft製の道具を見つけられなかったことを示します。確認したsetuptoolsの実装では、環境を設定する vcvarsall.bat が見つからないと、この文言を出します。

対処は、組み立て済みの配布物を使うか、ソースから組み立てるためのC++部品を導入するかです。Visual Studioの編集画面を含む本体を、必ず入れる必要はありません。

どのパッケージの組み立てで止まったかを読む

最後のエラー行だけでなく、その前にあるパッケージ名を確認してください。自分が指定したパッケージではなく、その依存先の組み立てが失敗していることもあります。

実例として、setuptoolsのIssue #4431では、Windows上でpyvexを導入する過程でcffiのソース配布物が選ばれ、その処理中に同じMSVCの要求が出ています。報告時の環境はPython 3.13の開発版とpip 24.1です。この報告だけで、現在の同じパッケージも必ず失敗するとは言えません。

実行に使うPythonの場所と版も記録します。以下はWindowsのコマンドプロンプト用です。

python --version
python -m pip --version
python -c "import sys, platform; print(sys.executable); print(platform.machine())"

以降の SomePackage は、実際に導入する配布名に置き換えてください。仮想環境を使っている場合は、その環境のPythonで実行します。

組み立て済みの配布物だけで導入できるかを確認する

wheelは、導入用に組み立てて配布されるファイルです。Python Packaging User Guideによると、pipは対応するwheelを優先し、見つからなければソース配布物からwheelを作ります。C/C++の拡張を含むソースを使うと、手元の組み立て用の道具が必要になる場合があります。

ソースを使わずに導入したい場合は、次を実行します。

python -m pip install --only-binary=:all: SomePackage

pipの公式説明では、この指定はソース配布物を使用しません。必要な依存先も含めて条件に合うwheelが無ければ、導入は失敗します。失敗した場合は、表示された配布名について、対応するPythonの版やWindows向けの配布ファイルを確認してください。

これはMSVCを導入する指定ではありません。ソースからの組み立てを避けられるかを判断する方法です。

--prefer-binary は、より新しいソース配布物があってもwheelを優先する別の指定です。ソースの利用自体を禁止するものではないため、組み立てを確実に避けたい場合は --only-binary=:all: を使います。

Build ToolsではC++の部品を選ぶ

ソースから組み立てる必要がある場合は、Microsoft C++ Build Toolsの配布ページから入手します。

Microsoftの導入案内は、コマンドだけで組み立てる道具が必要ならBuild Toolsを入れ、Desktop development with C++を選ぶよう案内しています。日本語の画面ではC++によるデスクトップ開発に相当する項目を確認します。

導入済みならVisual Studio Installerで対象製品を変更し、C++の項目を確認してください。Build Tools 2022の構成一覧では、MSVCのx64/x86用ツールとWindows SDKが推奨部品に含まれています。実際の部品名や版は、導入する製品と対象のCPUによって異なります。

エラーに14.0と書かれていても、それだけを理由に古いVisual Studio 2015を探す必要はありません。確認したsetuptoolsは、Visual Studio 2017以降の導入先を先に探します。ただし、個々のパッケージが指定する対応コンパイラやSDKの条件は、別に満たす必要があります。

導入済みなのに見つからない場合を調べる

Build Toolsという製品が入っていることと、必要なC++部品が見つかることは別です。setuptoolsの実装は vswhere.exe でC++のツールを含む導入先を探し、その中の vcvarsall.bat の存在を確認します。

x86/x64向けの部品を調べる場合は、コマンドプロンプトで次を実行できます。

"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath

これはsetuptoolsの探索条件の一部を使った確認です。実装で指定される -prerelease は省略しており、ARM64向けの判定もこのコマンドには含めていません。

導入先が出なければ、まずInstallerでC++部品を確認します。vswhere.exe 自体が見つからない場合は、上のコマンドでは部品の有無を判断できません。導入先が表示された場合は、その下の VC\Auxiliary\Build\vcvarsall.bat があるかも確認します。

確認した実装には、DISTUTILS_USE_SDK が設定されていると探索を飛ばし、現在の環境を使う分岐もあります。この変数を設定するだけではコンパイラは追加されないため、エラーを消す目的だけで設定する対処は避けます。

再実行後はエラーが変わったかを確認する

導入が終わったら、新しいコマンドプロンプトで対象の仮想環境を有効にし、同じ導入を試します。

python -m pip install SomePackage

同じエラーなら、C++部品の選択と探索結果を再確認します。別のコンパイルエラーや、ヘッダーファイルが無いというエラーに変わった場合は、その新しい文言を調べてください。MSVCを見つけられても、パッケージ固有の追加部品が必要な場合があります。

なお、通常のコマンドプロンプトで cl が見つからないことだけでは、MSVC未導入とは判断できません。Microsoftは開発者向けコマンドプロンプトで組み立て用の環境を設定する仕組みを説明しています。setuptoolsにも、見つけた vcvarsall.bat を呼び出して環境を取得する処理があります。

本記事のWindows向けコマンドと導入操作は実機では未検証です。説明は2026年10月19日に確認した公式資料とsetuptoolsの実装に基づきます。

似ている導入エラーとの違い

pipのNo matching distribution foundは、条件に合う配布物が見つからない段階のエラーです。本件はソースの組み立てに進んだあと、MSVCの環境を見つけられない場合に出ます。--only-binary を指定した結果、前者に変わることもあります。

pipのexternally-managed-environmentは、外部の管理者が管理するPython環境への導入を制限する仕組みです。C++の部品不足とは別の問題です。

node-gypのbuild errorもWindowsではC++の道具が関わる場合がありますが、Node.js側の組み立てです。本記事のPython用コマンドとは分けて確認します。

subprocess-exited-with-error は、Issue #4431でも同じMSVCエラーに続いて表示されています。その行だけで原因を決めず、前にある具体的なエラーを読みます。

解決手順のまとめ

まず組み立てに失敗した配布名と、使用しているPythonを確認します。対応するwheelがあるなら、組み立てを避けて導入できます。

ソースが必要ならBuild ToolsのC++部品を確認し、導入先と vcvarsall.bat の存在を調べます。Build Toolsを入れただけで終わりにせず、同じPythonで再実行して、MSVCの要求が解消したかまで確認してください。

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。