コマンド ラインから Microsoft C++ ビルド ツールを使用する

Visual Studioに含まれているツールを使用して、コマンド ラインで C および C++ アプリケーションをビルドできます。 Microsoft C++ (MSVC) ビルド ツールをスタンドアロン パッケージとしてダウンロードすることもできます。 Visual Studio IDEを使用する予定がない場合は、インストールする必要はありません。

注

この記事では、個々のコンパイラ、リンカー、ライブラリ、およびその他の基本的なツールを使用するように環境を設定する方法について説明します。 MSBuild に基づくVisual Studioのネイティブ プロジェクト ビルド システムでは、この記事で説明するように環境は使用されません。 コマンド ラインから MSBuild を使用する方法については、「コマンド ラインでの MSBuild - C++」をご覧ください。

ツールのダウンロードとインストール

Visual Studioと C++ ワークロードをインストールした場合は、すべてのコマンド ライン ツールがあります。 C++ とVisual Studioをインストールする方法については、 Visual Studioを参照してください。

コマンド ライン ツールセットのみが必要な場合は、Build Tools for Visual Studioをダウンロードします。 ダウンロード ページで、Tools for Visual Studio を展開してビルド ツールのダウンロードを見つけます。 ダウンロードした実行可能ファイルを実行すると、Visual Studio インストーラーが更新されて実行されます。

C++ の開発に必要なツールのみをインストールするには、[C++ によるデスクトップ開発] ワークロードを選択します。 [ インストールの詳細] で、オプションのライブラリとツールセットを選択できます。 Visual Studio 2015、Visual Studio 2017、または Visual Studio 2019 ツールセットを使用してコードをビルドするには、オプションの MSVC v140、v141、または v142 ビルド ツールを選択します。 選択が完了したら、[インストール] を選択します。

コマンド ライン ツールの使用方法

Visual Studio インストーラーでいずれかの C++ ワークロードを選択すると、既定で MSVC ビルド ツール パッケージの特定のバージョンがインストールされます。 Visual Studio 2022 以前の場合、パッケージは、特定のバージョンのVisual Studioのすべての C および C++ ツールを含む platform ツールセット (v### バージョン形式) で編成されています。 Visual Studio 2026 以降では、MSVC バージョンは Visual Studio バージョンから切り離されています。 つまり、Visual Studio 2026 以降、パッケージは MSVC ツールセットのバージョン (v##.## バージョン形式) に対応します。これには、その特定の MSVC ビルド ツール パッケージのすべての C および C++ ツールが含まれています。

ツールには、C/C++ コンパイラ、リンカー、アセンブラー、およびその他のビルド ツールが含まれます。 これには、一致するライブラリとヘッダー ファイルが含まれます。 これらのツールはすべてコマンド ラインで使用できます。 Visual Studio IDEでは、内部的に使用されます。 x86、x64、ARM、ARM64 のターゲット用のコードをビルドする、x86 ホスト型および x64 ホスト型のコンパイラとツールがあります。 特定のホストやターゲット ビルド アーキテクチャに対するそれぞれのツール セットは、その独自のディレクトリに保存されています。

ツールには、いくつかの環境変数を設定する必要があります。 これらの変数は、パスにツールを追加し、インクルード ファイル、ライブラリ ファイル、SDK の場所を設定します。 このような環境変数をかん単に設定する目的で、インストーラーにより、インストール中、カスタマイズされたコマンド ファイルまたはバッチ ファイルが作成されます。 これらのコマンド ファイルのいずれかを実行して、特定のホストとターゲットのビルド アーキテクチャ、Windows SDK バージョン、プラットフォーム ツールセットを設定できます。

便宜上、インストーラーは スタート メニューにもショートカットを作成します。 ショートカットでは、ホストアーキテクチャとターゲットアーキテクチャの特定の組み合わせに対してこれらのコマンドファイルを使用して、開発者のコマンド プロンプト ウィンドウを開きます。 これらのショートカットによって、必要なすべての環境変数が設定され、使用できるようになります。

必須の環境変数はインストールに固有であり、選択したビルド アーキテクチャに固有となります。 製品の更新またはアップグレードによって変数が変更される場合があります。 この変動性は、環境変数を自分で設定するのではなく、インストールされたコマンド プロンプト ショートカットまたはコマンド ファイルを使用することをお勧めする理由の 1 つです。

インストーラーによって追加されるツールセット、コマンド ファイル、ショートカットは、コンピューター プロセッサとインストール時に選択するオプションによって異なります。 x86 および x64 コードをビルドする x86 ホスト ツールとクロス ツールは、常にインストールされます。 64 ビット Windowsがある場合は、x86 および x64 コードをビルドする x64 ホスト型ツールとクロス ツールもインストールされます。 オプションの C++ ユニバーサル Windows プラットフォーム ツールを選択すると、ARM および ARM64 コードをビルドする x86 および x64 ツールもインストールされます。 その他のワークロードでは、これらのツールをインストールできます。

コマンド ライン ビルドのためのパスと環境変数

MSVC コマンド ライン ツールでは、 PATH、 TMP、 INCLUDE、 LIB、および LIBPATH 環境変数が使用されます。 また、インストールされているツール、プラットフォーム、SDK に固有の他の環境変数も使用します。 単純なVisual Studioインストールでも、20 個以上の環境変数を設定できます。 この複雑さのため、開発者コマンド プロンプト ショートカットまたはカスタマイズされたコマンド ファイルのいずれかを使用することを強くお勧めします。 これらの変数は、Windows環境で自分で設定することはお勧めしません。

開発者コマンド プロンプトのショートカット セットの環境変数を確認するには、 SET コマンドを使用します。 プレーンなコマンド プロンプト ウィンドウを開き、ベースラインの SET コマンドの出力をキャプチャします。 開発者コマンド プロンプト ウィンドウを開き、比較のために SET コマンドの出力をキャプチャします。 Visual Studioに組み込まれている差分ツールを使用して、開発者コマンド プロンプトによって設定された環境変数を強調表示します。 コンパイラ環境変数とリンカー環境変数の詳細については、「CL 環境変数」を参照してください。

開発者コマンド プロンプト ショートカット

コマンド プロンプトのショートカットは、Windows Start メニューのバージョン固有のVisual Studio フォルダーにインストールされます。 次は、基本的なコマンド プロンプト ショートカットとそれによりサポートされるビルド アーキテクチャを一覧にまとめたものです。

• 開発者コマンド プロンプト。 32 ビット x86 ツールを使用して 32 ビット x86 コードをビルドするように環境を設定します。
• x86 Native Tools コマンド プロンプト。 32 ビット x86 ツールを使用して 32 ビット x86 コードをビルドするように環境を設定します。
• x64 Native Tools コマンド プロンプト。 64 ビット x64 ツールを使用して 64 ビット x64 コードをビルドするように環境を設定します。
• x86_x64 クロス ツール コマンド プロンプト 32 ビット x86 ツールを使用して 64 ビット x64 コードをビルドするように環境を設定します。
• x64_x86 クロス ツール コマンド プロンプト 64 ビット x64 ツールを使用して 32 ビット x86 コードをビルドするように環境を設定します。

Start メニュー フォルダーとショートカット名は、インストールされているバージョンのVisual Studioによって異なります。 たとえば、Visual Studio 2022 の開発者コマンド プロンプトのショートカットは、Start>Programs>Visual Studio 2022>Visual Studio Tools で Developer Command Prompt for VS 2022 という名前になっています。

注

いくつかのコマンド ライン ツールまたはツール オプションには管理者特権が必要です。 使用するときにアクセス許可の問題がある場合は、[ 管理者として実行 ] オプションを使用して開発者コマンド プロンプト ウィンドウを開いてお勧めします。 右クリックして[コマンド プロンプト]ウィンドウのショートカット メニューを開き、[その他]>[管理者として実行]を選択します。

開発者コマンド プロンプト ウィンドウを開くには

1. デスクトップで、Windows Start メニューを開きます。 Windows 11で、[すべてのアプリを選択して、インストールされているアプリの一覧を開きます。 Windows 10では、リストは左側に開いています。 一覧を下へスクロールし、お使いの Visual Studio のバージョンに対応するフォルダー（アプリではありません）を見つけて開きます。たとえば、Visual Studio 2022 や、バージョン 2026 以降では Visual Studio です。
2. フォルダーで、Visual Studioのバージョンの Developer コマンド プロンプト を選択します。 このショートカットは、32 ビット x86 ツールを使用して 32 ビット x86 コードをビルドするように環境を設定する開発者コマンド プロンプト ウィンドウを起動します。 既定以外のビルド アーキテクチャを使用する場合は、ネイティブまたはクロス ツールのコマンド プロンプトのいずれかを選択して、ホストとターゲットのアーキテクチャを指定します。

開発者コマンド プロンプト ウィンドウをもっと速く起動するには、デスクトップの検索ボックスに「developer command prompt」と入力します。 それから、目的の結果を選択します。

注

既定では、開発者コマンド プロンプトの現在の作業ディレクトリは、Program Files ディレクトリ内のVisual Studioインストールのルートです。 この場所は、コードやプロジェクトには適していません。 プロジェクトを作成する前に、現在の作業ディレクトリを別の場所に変更します。 IDE は、ユーザー ディレクトリ (通常は %USERPROFILE%\source\repos) にプロジェクトを作成します。

開発者コマンド ファイルの場所

既存のコマンド プロンプト ウィンドウでビルド環境を設定する場合は、インストーラーによって作成されたコマンド ファイルのいずれかを使用できます。 新しいコマンド プロンプト ウィンドウで環境を設定することをお勧めします。 後で同じコマンド ウィンドウで環境を切り替えることはお勧めしません。

コマンド ファイルの場所は、インストールしたVisual Studioのバージョンと、インストール時に行った選択によって異なります。 Visual Studio 2022 の場合、一般的なインストール場所は C:\Program Files\Microsoft Visual Studio\2022\<edition> です。 <edition>には、Community、Professional、Enterprise、BuildToolsを指定できます。

プライマリ開発者コマンド プロンプト コマンド ファイル ( VsDevCmd.bat) は、 Common7\Tools ディレクトリにあります。 パラメーターを指定しない場合、x86 ネイティブ ツールを使用して 32 ビット x86 コードをビルドするように環境が設定されます。

特定のビルド アーキテクチャを設定するためコマンド ファイルは他にもあります。 使用できるコマンド ファイルは、インストールしたVisual Studioのワークロードとオプションによって異なります。 Visual Studio 2017 および Visual Studio 2019 では、VC\Auxiliary\Build ディレクトリにあります。

これらのコマンド ファイルにより既定のパラメーターが設定され、VsDevCmd.bat が呼び出されて指定のビルド アーキテクチャ環境が設定されます。 一般的なインストールには、次のコマンド ファイルが含まれる場合があります。

コマンド ファイル	ホストおよびターゲット アーキテクチャ
vcvars32.bat	32 ビット x86 ネイティブ ツールを使用し、32 ビット x86 コードをビルドします。
vcvars64.bat	64 ビット x64 ネイティブ ツールを使用し、64 ビット x64 コードをビルドします。
vcvarsx86_amd64.bat	32 ビット x86 ネイティブ クロス ツールを使用し、64 ビット x64 コードをビルドします。
vcvarsamd64_x86.bat	64 ビット x64 ネイティブ クロス ツールを使用し、32 ビット x86 コードをビルドします。
vcvarsx86_arm.bat	32 ビット x86 ネイティブ クロス ツールを使用し、ARM コードをビルドします。
vcvarsamd64_arm.bat	64 ビット x64 ネイティブ クロス ツールを使用し、ARM コードをビルドします。
vcvarsx86_arm64.bat	32 ビット x86 ネイティブ クロス ツールを使用し、ARM64 コードをビルドします。
vcvarsamd64_arm64.bat	64 ビット x64 ネイティブ クロス ツールを使用し、ARM64 コードをビルドします。
vcvarsall.bat	パラメーターを使用して、ホストとターゲットのアーキテクチャ、Windows SDK、プラットフォームの選択肢を指定します。 サポートされているオプションの一覧が必要な場合、/help パラメーターを使用して呼び出します。

注意事項

vcvarsall.bat ファイルとその他のVisual Studioコマンド ファイルは、コンピューターによって異なる場合があります。 別のコンピューターのファイルを使用して、見つからないファイルや破損した vcvarsall.bat ファイルを置き換えないでください。 Visual Studio インストーラーを再実行して、見つからないファイルを置き換えます。

vcvarsall.bat ファイルは、バージョンによっても異なります。 Visual Studioの現在のバージョンが以前のバージョンのVisual Studioを持つコンピューターにインストールされている場合は、同じコマンド プロンプト ウィンドウで別のバージョンの vcvarsall.bat または別のVisual Studio コマンド ファイルを実行しないでください。

既存のコマンド ウィンドウで開発者ツールを使用する

既存のコマンド ウィンドウで特定のビルド アーキテクチャを指定する最も簡単な方法は、vcvarsall.bat ファイルを使用することです。 vcvarsall.batを使用して環境変数を設定し、ネイティブの 32 ビットまたは 64 ビットコンパイル用にコマンド プロンプト ウィンドウを構成します。 引数を使用すると、x86、x64、ARM、または ARM64 プロセッサのクロスコンパイルを指定できます。 Microsoft Store、ユニバーサル Windows プラットフォーム、または Windows Desktop プラットフォームをターゲットにすることができます。 使用する SDK Windowsを指定し、プラットフォーム ツールセットのバージョンを選択することもできます。

引数なしで vcvarsall.bat を使用すると、32 ビット Windows Desktop ターゲットに対して現在の x86 ネイティブ コンパイラを使用するように環境変数が構成されます。 ネイティブ またはクロス コンパイラ ツールのいずれかを使用するように環境を構成するための引数を追加します。 vcvarsall.bat インストールされていない構成、またはコンピューターで使用できない構成を指定した場合は、エラー メッセージが表示されます。

vcvarsall 構文

vcvarsall.bat [architecture] [platform_type] [winsdk_version] [-vcvars_ver=vcversion] [spectre_mode]

• architecture

  この任意の引数では、使用するホストおよびターゲット アーキテクチャが指定されます。 architectureを指定しない場合は、既定のビルド環境が使用されます。 次の引数がサポートされています。

  architecture	コンパイラ	ホスト コンピューターのアーキテクチャ	ビルド出力 (ターゲット) のアーキテクチャ
  x86	x86 32 ビット ネイティブ	x86、x64	x86
  x86_amd64 または x86_x64	x64 on x86 クロス	x86、x64	X64
  x86_arm	ARM on x86 クロス	x86、x64	ARM
  x86_arm64	ARM64 on x86 クロス	x86、x64	ARM64
  amd64 または x64	x64 64 ビット ネイティブ	X64	X64
  amd64_x86 または x64_x86	x86 on x64 クロス	X64	x86
  amd64_arm または x64_arm	ARM on x64 クロス	X64	ARM
  amd64_arm64 または x64_arm64	ARM64 on x64 クロス	X64	ARM64

• platform_type

  この省略可能な引数は、プラットフォームの種類として store または uwp を指定します。 既定では、デスクトップまたはコンソール アプリをビルドするように環境が設定されます。

• winsdk_version

  必要に応じて、使用する Windows SDK のバージョンを指定します。 既定では、インストールされている最新のWindows SDK が使用されます。 Windows SDK のバージョンを指定するには、10.0.10240.0 などの完全なWindows SDK 番号を使用するか、Windows 8.1 SDK を使用するために 8.1 を指定します。

• vcversion

  必要に応じて、使用するVisual Studioコンパイラ ツールセットを指定します。 既定では、環境では、インストールされている最新のVisual Studio コンパイラ ツールセットが使用されます。 次の表に、 vcvars_ver 値の例を示します。

  vcvars_ver={value}	結果	VS 2026 の例	VS 2022 の例	VS 2019 の例	VS 2017 の例
  "Preview"	Visual Studio プレビュー コンパイラ ツールセットを使用します。	Supported	サポートしていません	サポートしていません	サポートしていません
  "14.0"	Visual Studio 2015 コンパイラ ツールセットを使用します。	Supported	Supported	Supported	Supported
  "14.xx"	インストールされている最新の 14.xx.yyyyy ツールセットを使用します。	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	特定の完全なバージョン番号を使用します。	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Spectre の軽減策を含まないライブラリを使用する場合は、このパラメーターは省略してください。 Spectre 緩和策が適用されたライブラリを使用するには、spectre を指定します。

既存のコマンド プロンプト ウィンドウでビルド環境を設定するには

1. コマンド プロンプトで、CD コマンドを使用して、Visual Studio インストール ディレクトリに変更します。 たとえば、Visual studio 2026 を使用している場合は、C:\Program Files\Microsoft Visual Studio\18\Professional。 次に、 CD を再度使用して、構成固有のコマンド ファイルを含むサブディレクトリに変更します。 Visual Studio 2017 以降の場合は、VC\Auxiliary\Build サブディレクトリを使用します。 Visual Studio 2015 の場合は、VC サブディレクトリを使用します。

2. 優先開発者環境のコマンドを入力します。 たとえば、最新の Windows SDK と Visual Studio コンパイラ ツールセットを使用して、64 ビット プラットフォームで UWP 用の ARM コードをビルドするには、次のコマンドを使用します。

   vcvarsall.bat amd64_arm uwp
   

独自のコマンド プロンプト ショートカットを作成する

開発者コマンド プロンプト ショートカットの [プロパティ ] ダイアログを開き、使用されているコマンド ターゲットを表示します。 たとえば、 VS 2022 の開発者コマンド プロンプト ショートカットの ターゲットは次のようになります。

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\Tools\VsDevCmd.bat"

アーキテクチャ固有のバッチ ファイルにより、architecture パラメーターが設定され、vcvarsall.bat が呼び出されます。 vcvarsall.batに渡すのと同じオプションをこれらのバッチ ファイルに渡すか、vcvarsall.batを直接呼び出すことができます。 独自のコマンド ショートカットのパラメーターを指定するには、コマンドの末尾に二重引用符で囲んで追加します。 以前のコンパイラ ツールセットを使用するには、バージョン番号を指定します。

ARM32 ターゲットは削除されたため、Visual Studio 2026 以降では ARM64 のみをターゲットにすることができます。

最新の Windows SDK を使用して、64 ビット プラットフォームで UWP 用の ARM64 コードをビルドするショートカットを次に示します。 ARM64 のターゲット指定は、Visual Studio 2026 以降で表示されます。 ARM32 のターゲット設定は、以前のバージョンで示されています。

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.44

Visual Studioインストール ディレクトリを反映するようにパスを調整します。 vcvarsall.bat ファイルには、特定のバージョン番号に関する詳細情報が含まれています。

コマンド ライン ツール

コマンド プロンプトで C/C++ プロジェクトをビルドするには、Visual Studio次のコマンド ライン ツールを提供します。

• Cl

  コンパイラ (cl.exe) を使用して、ソース コード ファイルをコンパイルし、アプリ、ライブラリ、DLL にリンクします。

• Link

  リンカー (link.exe) を使用して、コンパイル済みのオブジェクト ファイルとライブラリをアプリと DLL にリンクします。

コマンド ラインでビルドするとき、F1 コマンドでヘルプを瞬時に表示することはできません。 代わりに、検索エンジンを使用して警告、エラー、メッセージに関する情報を取得できます。 また、オフラインのヘルプ ファイルをダウンロードして使用することもできます。 Microsoft Learn で検索を使用するには、任意の記事の上部にある検索ボックスにクエリを入力します。

コマンド ライン プロジェクト管理ツール

既定では、Visual Studio IDEは MSBuild に基づくネイティブ プロジェクト ビルド システムを使用します。 IDE を使用せずに MSBuild を直接呼び出してプロジェクトをビルドできます。 devenv コマンドを使用して、Visual Studioを使用してプロジェクトとソリューションをビルドすることもできます。 Visual Studioでは、CMake または NMake に基づくビルド システムもサポートされます。

• MSBuild

  MSBuild (msbuild.exe) とプロジェクト ファイル (.vcxproj) を使用してビルドを構成し、Visual Studio IDEを読み込まずにツールセットを呼び出します。 これは、Visual Studio IDEで Build プロジェクトまたは Build Solution コマンドを実行することと同じです。 コマンド ラインでビルドする場合、MSBuild には IDE より優れた利点があります。 ご利用のすべてのビルド サーバーおよびビルド パイプラインに、完全な IDE をインストールする必要があるわけではありません。 IDE の余分なオーバーヘッドを回避できます。 MSBuild はコンテナー化されたビルド環境で実行され、バイナリ ロガーをサポートします。

• Devenv

  Visual Studio IDEを表示せずに特定のビルド コマンドを実行するには、deVENV (devenv.exe) を /Build や /Clean などのコマンド ライン スイッチと組み合わせて使用します。

• CMake

  CMake (cmake.exe) は、複数のプラットフォームで実行されるビルド プロセスを定義するためのクロスプラットフォーム オープンソース ツールです。 CMake では、サポートされているプラットフォーム (MSBuild や Make など) のネイティブ ビルド ツールを構成および制御できます。 CMake の詳細については、CMake のドキュメントをご覧ください。

• Nmake

  NMAKE (nmake.exe) を使用して、従来のメイクファイルを使用して C++ プロジェクトをビルドします。

注

Visual Studio 2019 バージョン 16.5 以降では、MSBuild と DEVENV はコマンドライン環境を使用して使用されるツールセットとライブラリを制御しません。

関連項目

• チュートリアル: コマンドラインでネイティブ C++ プログラムをコンパイルする
• チュートリアル: コマンド ラインでの C プログラムのコンパイル
• チュートリアル: コマンド ラインでの C++/CLI プログラムのコンパイル
• チュートリアル: コマンド ラインでの C++/CX プログラムのコンパイル
• プロジェクトおよびビルド システム
• /MD、 /MT、 /LD (ランタイム ライブラリを使用)
• C/C++ コンパイラ オプション
• MSVC リンカー オプション
• 追加の MSVC ビルド ツール