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

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

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

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

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 以上の環境変数が設定される場合があります。 この複雑さは、開発者コマンド プロンプトのショートカットまたはカスタマイズされたコマンド ファイルの 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 ネイティブ コードをビルドするように環境を設定します。

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

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

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

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

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

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

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

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

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

既存のコマンド ウィンドウで特定のビルド アーキテクチャを指定する最も簡単な方法は、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
この任意の引数では、使用するホストおよびターゲット アーキテクチャが指定されます。 アーキテクチャが指定されていない、既定のビルド環境が使用されます。 以下の引数がサポートされています。

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 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

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

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

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++ プロジェクトをビルドできます。

このセクションの内容

これらの記事では、コマンド ラインでアプリを作成する方法と、コマンドライン ビルド環境をカスタマイズする方法を説明します。 一部の記事では、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++ ビルド ツールへのリンクがあります。

関連項目

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