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

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

Note

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

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

Visual Studio と C++ ワークロードがインストールされている場合は、すべてのコマンドライン ツールを使用できます。 C++ と Visual Studio をインストールする方法について詳しくは、「Visual Studio での C++ サポートのインストール」をご覧ください。 コマンドライン ツールセットのみが必要な場合、Build Tools for Visual Studio をダウンロードしてください。 ダウンロードした実行可能ファイルを実行すると、Visual Studio インストーラーが更新され、実行されます。 C++ の開発に必要なツールのみをインストールするには、[C++ によるデスクトップ開発] ワークロードを選択します。 オプションのライブラリとツールセットを選択し、[インストールの詳細] に含めることができます。 Visual Studio 2015、2017、または 2019 のツールセットを使用してコードをビルドするには、オプションの MSVC v140、v141、または v142 のビルド ツールを選択します。 選択が完了したら、[インストール] を選択します。

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

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

ツールが正しく動作するには、特定の環境変数をいくつか設定する必要があります。 これらの変数は、ツールをパスに追加したり、インクルード ファイル、ライブラリ ファイル、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 以上の環境変数が設定される場合があります。 この複雑さは、 developer コマンド プロンプト のショートカット または カスタマイズされたコマンド ファイルの 1 つを使用することを強くお勧めする理由です。 これらの変数は、Windows 環境で自分で設定することはお勧めしません。

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

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

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

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

[スタート] メニューのフォルダーとショートカットの名前は、インストールされている Visual Studio のバージョンによって異なります。 設定した場合は、インストール ニックネームにも依存します。 たとえば、Visual Studio 2022 をインストールし、 Latest のニックネームを付けたとします。 開発者コマンド プロンプトのショートカットは、vs 2022 (Latest) のDeveloper コマンド プロンプト名前が付けられ、Visual Studio 2022 という名前です。

Note

コマンド ライン ツールまたはツールのオプションによっては、管理者アクセス許可が必要になる場合があります。 それらを使用するとアクセス許可の問題が発生する場合は、[管理者として実行] オプションを使用して開発者コマンド プロンプト ウィンドウを開くことをお勧めします。 右クリックしてコマンド プロンプト ウィンドウのショートカット メニューを開き、[詳細]、[管理者として実行] の順に選択します。

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

1. デスクトップで、Windows Start メニューを開きます。 Windows 11 で、 [すべてのアプリ ] ボタンを選択して、インストールされているアプリの一覧を開きます。 Windows 10 では、一覧が左側に開いています。 一覧を下にスクロールして、Visual Studio のバージョンのフォルダー (アプリではなく) を見つけて開きます (例: Visual Studio 2022。

2. フォルダーで、お使いのバージョンの Visual Studio の [開発者コマンド プロンプト] を選択します。 このショートカットにより、32 ビット x86 ネイティブ ツールの既定のビルド アーキテクチャを使用して 32 ビット x86 ネイティブ コードをビルドする開発者コマンド プロンプト ウィンドウが起動します。 既定以外のビルド アーキテクチャを使用する場合、いずれかのネイティブまたはクロス ツール コマンド プロンプトを選択し、ホストおよびターゲット アーキテクチャを指定します。

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

Note

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

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

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

コマンド ファイルの場所は、インストールした Visual Studio のバージョンとインストール中に選択した場所によって変わります。 Visual Studio 2019 の場合、64 ビット システム上の一般的なインストール場所は \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 ファイルを使用することです。 環境変数を設定し、ネイティブ 32 ビットまたは 64 ビット コンパイルのコマンド ラインを構成するには vcvarsall.bat を使用します。 引数を使用すると、x86、x64、ARM、または ARM64 プロセッサのクロスコンパイルを指定できます。 Microsoft Store、ユニバーサル Windows プラットフォーム、または Windows デスクトップ プラットフォームを対象にできます。 使用する Windows SDK を指定し、プラットフォーム ツールセットのバージョンを選択することもできます。

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

vcvarsall の構文

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

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 番号を使用するか、8.1 と指定して Windows 8.1 SDK を使用します。

vcversion
任意で、使用する Visual Studio コンパイラ ツールセットを指定します。 既定では、現在の Visual Studio コンパイラ ツールセットを使用するように環境が設定されます。

Visual Studio 2019 コンパイラ ツールセットの特定のバージョンを指定するには、-vcvars_ver=14.2x.yyyyy を使用します。

Visual Studio 2019 コンパイラ ツールセットの最新のバージョンを指定するには、-vcvars_ver=14.29 を使用します。

Visual Studio 2015 コンパイラ ツールセットを指定するには、-vcvars_ver=14.0 を使用します。

spectre_mode
Spectre の軽減策を含まないライブラリを使用する場合は、このパラメーターは省略してください。 Spectre の軽減策を含むライブラリを使用するには、値 spectre を使用します。

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

1. コマンド プロンプトで、CD コマンドを使用し、Visual Studio インストール ディレクトリに作業ディレクトリを変更します。 次に、CD をもう一度使用し、構成固有のコマンド ファイルが含まれるサブディレクトリに作業ディレクトリを変更します。 Visual Studio 2019 と Visual Studio 2017 の場合、VC\Auxiliary\Build サブディレクトリを使用します。 Visual Studio 2015 の場合、VC サブディレクトリを使用します。

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

   vcvarsall.bat amd64_arm uwp

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

アーキテクチャ固有のバッチ ファイルにより、 architecture パラメーターが設定され、vcvarsall.bat が呼び出されます。 vcvarsall.bat に渡す場合と同様に、これらのバッチ ファイルに同じオプションを渡すことができます。あるいは、vcvarsall.bat を直接呼び出すことができます。 独自のコマンド ショートカットのパラメーターを指定するには、それを二重引用符でコマンドの終わりに追加します。 たとえば、最新の Windows SDK を使用し、64 ビット プラットフォームで UWP の ARM コードをビルドするショートカットを次に示します。 以前のコンパイラ ツールセットを使用するには、バージョン番号を指定します。 ショートカットで次のようなコマンド ターゲットを使用します。

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

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 で [プロジェクトのビルド] コマンドまたは [ソリューションのビルド] コマンドを実行することと同じです。 コマンド ラインでビルドする場合、MSBuild には IDE より優れた利点があります。 ご利用のすべてのビルド サーバーおよびビルド パイプラインに、完全な IDE をインストールする必要があるわけではありません。 IDE の余分なオーバーヘッドを回避できます。 MSBuild はコンテナー化されたビルド環境で実行され、バイナリ ロガーをサポートします。

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

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

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

Note

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

このセクションの内容

これらの記事では、コマンド ラインでアプリを作成する方法と、コマンドライン ビルド環境をカスタマイズする方法を説明します。 一部の記事では、64 ビット ツールセットを使用する方法と、x86、x64、ARM、ARM64 の各プラットフォームを対象とする方法を紹介しています。 また、コマンドライン ビルド ツール MSBuild と NMAKE の使用方法について説明します。

チュートリアル: コマンド ラインでのネイティブ C++ プログラムのコンパイル
コマンド ラインで C++ プログラムを作成およびコンパイルする方法を示す例があります。

チュートリアル: コマンド ラインでの C プログラムのコンパイル
C プログラミング言語で書かれたプログラムをコンパイルする方法について説明します。

チュートリアル: コマンド ラインでの C++/CLI プログラムのコンパイル
.NET Framework を使用する C++/CLI プログラムを作成およびコンパイルする方法について説明します。

チュートリアル: コマンド ラインでの C++/CX プログラムのコンパイル
Windows ランタイムを使用する C++/CX プログラムを作成およびコンパイルする方法について説明します。

NMAKE リファレンス
NMAKE.EXE (Microsoft Program Maintenance Utility) について説明する記事へのリンクがあります。

コマンド ラインでの MSBuild - C++
コマンド ラインから msbuild.exe を使用する方法について説明する記事へのリンクがあります。

関連セクション

/MD、/MT、/LD (ランタイム ライブラリの使用)
デバッグ バージョンまたはリリース バージョンのランタイム ライブラリを使用するための、コンパイラ オプションの使用方法について説明します。

C/C++ コンパイラ オプション
C と C++ のコンパイラ オプションおよび CL.exe に関する記事へのリンクがあります。

MSVC リンカー オプション
リンカー オプションおよび LINK.exe に関する記事へのリンクがあります。

追加の MSVC ビルド ツール
Visual Studio に含まれている C/C++ ビルド ツールへのリンクがあります。

関連項目

プロジェクトおよびビルド システム