Utiliser les outils de génération Microsoft C++ à partir de la ligne de commande

Vous pouvez générer des applications C et C++ sur la ligne de commande à l’aide d’outils inclus dans Visual Studio. Vous pouvez également télécharger les outils de génération Microsoft C++ (MSVC) en tant que package autonome. Vous n'avez pas besoin d'installer le IDE Visual Studio si vous n'envisagez pas de l'utiliser.

Télécharger et installer les outils

Comment utiliser les outils en ligne de commande

Lorsque vous choisissez l’une des charges de travail C++ dans le programme d’installation Visual Studio, elle installe une version spécifique du package MSVC Build Tools par défaut. Pour Visual Studio 2022 et versions antérieures, le package est organisé par un ensemble d’outils platforme (format de version v####) qui inclut tous les outils C et C++ pour une version spécifique de Visual Studio. À compter de Visual Studio 2026, la version MSVC est découplée de la version Visual Studio. En d’autres termes, à partir de Visual Studio 2026, le package correspond à la version de l’ensemble d’outils MSVC (format de version v#.###), qui inclut tous les outils C et C++ pour ce package MSVC Build Tools particulier.

Les outils incluent les compilateurs C/C++, les éditeurs de liens, les assembleurs et d’autres outils de génération. Il inclut les bibliothèques correspondantes et les fichiers d’en-tête. Vous pouvez utiliser tous ces outils sur la ligne de commande. La IDE Visual Studio les utilise en interne. Il existe des compilateurs et des outils hébergés par x86 et x64 distincts qui créent du code pour les cibles x86, x64, ARM et ARM64. Chaque ensemble d’outils propre à une architecture de build hôte et cible particulière est stocké dans son propre répertoire.

Les outils nécessitent la définition de plusieurs variables d’environnement. Ces variables ajoutent les outils au chemin d’accès et définissent les emplacements des fichiers include, des fichiers de bibliothèque et des kits SDK. Pour faciliter la définition de ces variables d’environnement, le programme d’installation crée des fichiers de commandes personnalisés lors de l’installation. Vous pouvez exécuter l’un de ces fichiers de commandes pour définir une architecture de build hôte et cible spécifique, Windows version du SDK et un ensemble d’outils de plateforme.

Pour plus de commodité, le programme d’installation crée également des raccourcis dans votre menu Démarrer . Les raccourcis ouvrent les fenêtres d’invite de commandes du développeur en utilisant ces fichiers de commandes pour des combinaisons spécifiques d’architectures hôte et cible. Ces raccourcis garantissent que toutes les variables d’environnement requises sont définies et prêtes à être utilisées.

Les variables d’environnement requises sont spécifiques à votre installation et à l’architecture de build que vous choisissez. Les mises à jour ou mises à niveau des produits peuvent modifier les variables. Cette variabilité est une raison pour laquelle nous vous recommandons d’utiliser un raccourci d’invite de commandes installé ou un fichier de commandes, au lieu de définir vous-même les variables d’environnement.

Les ensembles d’outils, les fichiers de commandes et les raccourcis ajoutés par le programme d’installation dépendent du processeur de votre ordinateur et des options que vous sélectionnez lors de l’installation. Les outils hébergés par x86 et les outils croisés qui créent du code x86 et x64 sont toujours installés. Si vous avez des Windows 64 bits, les outils hébergés par x64 et les outils croisés qui créent du code x86 et x64 sont également installés. Si vous choisissez les outils de plateforme Windows universelle C++ facultatifs, les outils x86 et x64 qui créent du code ARM et ARM64 sont également installés. D’autres charges de travail permettent d’installer ces outils.

Variables de chemin d’accès et d’environnement pour les builds de ligne de commande

Les outils MSVC en ligne de commande utilisent les variables d’environnement PATH, TMP, INCLUDE, LIB et LIBPATH. Ils utilisent également d’autres variables d’environnement spécifiques à vos outils, plateformes et kits SDK installés. Même une installation simple Visual Studio peut définir vingt variables d’environnement ou plus. C'est en raison de cette complexité que nous vous recommandons vivement d’utiliser un raccourci d’une invite de commandes pour développeur ou l’un des fichiers de commandes personnalisés. Nous vous déconseillons de définir ces variables dans l'environnement Windows vous-même.

Pour voir quelles variables d’environnement sont définies par un raccourci d’invite de commandes développeur, utilisez la commande SET. Ouvrez une fenêtre standard de l’Invite de commandes et capturez la sortie de la commande SET comme référence. Ouvrez une fenêtre d’invite de commandes du développeur et capturez la sortie de la SET commande à des fins de comparaison. Utilisez un outil de différences tel que celui intégré à Visual Studio pour mettre en surbrillance les variables d’environnement définies par l’invite de commandes du développeur. Pour plus d’informations sur les variables d’environnement du compilateur et de l’éditeur de liens, consultez les variables d’environnement CL.

Raccourcis de l'invite de commandes du développeur

Les raccourcis d’invite de commande sont installés dans un dossier Visual Studio propre à la version, dans le menu Start de Windows. Voici la liste des principaux raccourcis d’invite de commandes et des architectures de build prises en charge :

• Invite de commandes pour les développeurs. Définit l’environnement pour utiliser des outils x86 32 bits pour générer du code x86 32 bits.
• Invite de commandes des outils natifs x86. Définit l’environnement pour utiliser des outils x86 32 bits pour générer du code x86 32 bits.
• Invite de commandes des outils natifs x64. Définit l’environnement pour utiliser des outils x64 64 bits afin de générer du code x64 64 bits.
• x86_x64 invite de commandes Cross Tools. Définit l’environnement pour utiliser des outils x86 32 bits afin de générer du code x64 64 bits.
• x64_x86 invite de commandes Cross Tools. Configure l’environnement pour utiliser des outils x64 64 bits afin de générer du code x86 32 bits.

Pour ouvrir une fenêtre d’invite de commandes du développeur

1. Sur le bureau, ouvrez le menu Windows Start. Dans Windows 11, choisissez All apps pour ouvrir la liste des applications installées. Dans Windows 10, la liste est ouverte à gauche. Faites défiler la liste pour rechercher et ouvrir le dossier (et non l’application) de votre version de Visual Studio, par exemple Visual Studio 2022 ou Visual Studio pour la version 2026 et ultérieures.
2. Dans le dossier, choisissez l’invite de commandes Developer pour votre version de Visual Studio. Ce raccourci ouvre une fenêtre d’invite de commandes pour développeurs qui configure l’environnement afin d’utiliser des outils x86 32 bits pour générer du code x86 32 bits. Si vous préférez une architecture de build non définie, choisissez l’une des invites de commande natives ou inter-outils pour spécifier l’architecture hôte et cible.

Pour un moyen encore plus rapide d’ouvrir une invite de commandes développeur, entrez invite de commandes développeur dans la boîte de recherche du bureau. Choisissez ensuite le résultat souhaité.

Emplacements des fichiers de commande des développeurs

Si vous préférez définir l’environnement de génération dans une fenêtre d’invite de commandes existante, vous pouvez utiliser l’un des fichiers de commande créés par le programme d’installation. Nous vous recommandons de définir l’environnement dans une nouvelle fenêtre d’invite de commandes. Nous vous déconseillons de changer d’environnement ultérieurement dans la même fenêtre de commande.

Le fichier de commande de l’invite de commandes principale du développeur, VsDevCmd.bat, se trouve dans le répertoire Common7\Tools. Lorsque vous ne spécifiez pas de paramètres, il définit l’environnement de sorte qu’il utilise les outils natifs x86 pour générer du code x86 32 bits.

Ces fichiers de commande définissent les paramètres par défaut et appellent VsDevCmd.bat pour configurer l’environnement d’architecture de build spécifié. Une installation classique peut inclure ces fichiers de commande :

Utiliser les outils de développement dans une fenêtre Commande existante

La façon la plus simple de spécifier une architecture de build particulière dans une fenêtre de commande existante consiste à utiliser le vcvarsall.bat fichier. Utilisez vcvarsall.bat pour définir des variables d’environnement afin de configurer la fenêtre d’Invite de commandes pour une compilation native en 32 bits ou 64 bits. Les arguments vous permettent de spécifier la compilation croisée en processeurs x86, x64, ARM ou ARM64. Vous pouvez cibler des plateformes Microsoft Store, plateforme Windows universelle ou Windows Desktop. Vous pouvez même spécifier les Windows SDK à utiliser, puis sélectionner la version de l’ensemble d’outils de plateforme.

Lorsque vous utilisez vcvarsall.bat sans argument, il configure les variables d’environnement pour utiliser le compilateur x86 natif actuel pour les cibles de bureau Windows Windows 32 bits. Ajoutez des arguments pour configurer l’environnement afin d’utiliser l’un des outils de compilateur natifs ou croisés. vcvarsall.bat affiche un message d’erreur si vous spécifiez une configuration qui n’est pas installée ou n’est pas disponible sur votre ordinateur.

Syntaxe de vcvarsall

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

• architecture

  Cet argument facultatif spécifie l’architecture hôte et cible à utiliser. Si vous ne spécifiez architecturepas, l’environnement de build par défaut est utilisé. Les arguments suivants sont pris en charge :

  architecture	Compilateur	Architecture de l’ordinateur hôte	Architecture (cible) de sortie de build
  x86	natif 32 bits x86	x86, x64	x86
  x86_amd64 ou x86_x64	x64 sur x86 croisé	x86, x64	x64
  x86_arm	ARM sur x86 croisé	x86, x64	ARM
  x86_arm64	ARM64 sur x86 croisé	x86, x64	ARM64
  amd64 ou x64	x64 64 bits natif	x64	x64
  amd64_x86 ou x64_x86	x86 sur x64 croisé	x64	x86
  amd64_arm ou x64_arm	ARM sur x64 croisé	x64	ARM
  amd64_arm64 ou x64_arm64	ARM64 sur x64 croisé	x64	ARM64

• platform_type

  Cet argument facultatif spécifie store ou uwp comme type de plateforme. Par défaut, l’environnement est défini pour générer des applications de bureau ou console.

• winsdk_version

  Spécifie éventuellement la version du SDK Windows à utiliser. Par défaut, la dernière version installée Windows SDK est utilisée. Pour spécifier la version Windows SDK, utilisez un numéro complet Windows SDK tel que 10.0.10240.0, ou spécifiez 8.1 pour utiliser le kit SDK Windows 8.1.

• vcversion

  Spécifie éventuellement l’ensemble d’outils du compilateur Visual Studio à utiliser. Par défaut, l’environnement utilise le dernier ensemble d’outils de compilateur installé Visual Studio. Le tableau suivant présente des exemples vcvars_ver de valeurs :

  vcvars_ver={value}	Résultat	Exemple VS 2026	Exemple VS 2022	Exemple VS 2019	Exemple VS 2017
  "Preview"	Utilisez l’ensemble d’outils du compilateur Visual Studio préversion.	Supported	Non pris en charge	Non pris en charge	Non pris en charge
  "14.0"	Utilisez l’ensemble d’outils du compilateur Visual Studio 2015.	Supported	Supported	Supported	Supported
  "14.xx"	Utilisez l’ensemble d’outils installé 14.xx.yyyyy le plus récent.	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Utilisez un numéro de version complet spécifique.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Laissez ce paramètre hors service pour utiliser des bibliothèques sans atténuations de Spectre. Spécifiez spectre pour utiliser des bibliothèques avec des protections contre Spectre.

Pour configurer l’environnement de génération dans une fenêtre d’invite de commandes existante

1. À l’invite de commandes, utilisez la commande CD pour passer au répertoire d’installation Visual Studio. Par exemple, C:\Program Files\Microsoft Visual Studio\18\Professional si vous utilisez Visual studio 2026. Ensuite, utilisez CD à nouveau pour passer au sous-répertoire qui contient les fichiers de commande spécifiques à la configuration. Pour Visual Studio 2017 et au-delà, utilisez le sous-répertoire VC\Auxiliary\Build. Pour Visual Studio 2015, utilisez le sous-répertoire VC.

2. Entrez la commande qui correspond à votre environnement de développement préféré. Par exemple, pour générer du code ARM pour UWP sur une plateforme 64 bits, à l’aide du kit de développement logiciel (SDK) Windows le plus récent et de l’ensemble d’outils de compilateur Visual Studio, utilisez cette commande :

   vcvarsall.bat amd64_arm uwp
   

Créer votre propre raccourci d’invite de commandes

%comspec% /k "C:\Program Files\Microsoft Visual Studio\18\Professional\VC\Auxiliary\Build\vcvars64.bat"

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat"

Les fichiers batch spécifiques à l’architecture définissent le architecture paramètre et appellent vcvarsall.bat. Vous pouvez passer les mêmes options à ces fichiers de commandes que pour vcvarsall.bat, ou vous pouvez simplement appeler vcvarsall.bat directement. Pour spécifier des paramètres pour votre propre raccourci de commande, ajoutez-les à la fin de la commande entre guillemets doubles. Pour utiliser un ensemble d’outils de compilateur antérieur, spécifiez le numéro de version.

Vous pouvez uniquement cibler ARM64 à partir de Visual Studio 2026, car le ciblage ARM32 a été supprimé.

Voici un raccourci pour générer du code ARM64 pour UWP sur une plateforme 64 bits, à l'aide du dernier sdk Windows. Le ciblage d’ARM64 s’affiche pour Visual Studio 2026 et versions ultérieures. Le ciblage d’ARM32 s’affiche pour les versions antérieures.

%comspec% /k "C:\Program Files\Microsoft Visual Studio\18\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm64 uwp -vcvars_ver=14.50

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

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0

Ajustez le chemin d’accès pour refléter votre répertoire d’installation Visual Studio. Le vcvarsall.bat fichier contient plus d’informations sur les numéros de version spécifiques.

Outils de ligne de commande

Pour générer un projet C/C++ à une invite de commandes, Visual Studio fournit ces outils en ligne de commande :

• CL

  Utilisez le compilateur (cl.exe) pour compiler et lier des fichiers de code source dans des applications, des bibliothèques et des DLL.

• Link

  Utilisez l’éditeur de liens (link.exe) pour lier des fichiers et bibliothèques d’objets compilés dans des applications et des DLL.

Lorsque vous compilez via la ligne de commande, la commande F1 n’est pas disponible pour l’aide instantanée. Au lieu de cela, vous pouvez utiliser un moteur de recherche pour obtenir des informations sur les avertissements, les erreurs et les messages. Vous pouvez également télécharger et utiliser les fichiers d’aide hors connexion. Pour utiliser la recherche dans Microsoft Learn, entrez votre requête dans la zone de recherche en haut de n’importe quel article.

Outils de gestion de projet en ligne de commande

Par défaut, le IDE Visual Studio utilise des systèmes de génération de projet natifs basés sur MSBuild. Vous pouvez appeler MSBuild directement pour générer des projets sans utiliser l’IDE. Vous pouvez également utiliser la commande devenv pour utiliser Visual Studio pour générer des projets et des solutions. Visual Studio prend également en charge la génération de systèmes basés sur CMake ou NMake.

• MSBuild

  Utilisez MSBuild (msbuild.exe) et un fichier projet (.vcxproj) pour configurer une build et appeler l’ensemble d’outils sans charger le IDE Visual Studio. Il équivaut à exécuter le projet Build ou Build Solution dans la commande IDE Visual Studio. MSBuild présente des avantages par rapport à l’IDE lorsque vous générez sur la ligne de commande. Vous n’avez pas besoin d’installer l’IDE complet sur tous vos serveurs de build et pipelines de build. Vous évitez la surcharge supplémentaire de l’IDE. MSBuild s’exécute dans des environnements de build conteneurisés et prend en charge un enregistreur d’événements binaire.

• DEVENV

  Utilisez DEVENV (devenv.exe) combiné à un commutateur de ligne de commande tel que /Build ou /Clean pour exécuter certaines commandes de build sans afficher la IDE Visual Studio.

• CMake

  CMake (cmake.exe) est un outil open source multiplateforme permettant de définir des processus de génération qui s’exécutent sur plusieurs plateformes. CMake peut configurer et contrôler des outils de génération natifs pour ses plateformes prises en charge, telles que MSBuild et Make. Pour plus d’informations sur CMake, consultez la documentation de CMake.

• NMAKE

  Utilisez NMAKE (nmake.exe) pour générer des projets C++ à l’aide d’un makefile traditionnel.

Voir aussi

• Procédure pas à pas : compilation d’un programme C++ natif sur la ligne de commande
• Procédure pas à pas : compiler un programme C sur la ligne de commande
• Procédure pas à pas : compilation d’un programme C++/CLI sur la ligne de commande
• Procédure pas à pas : compilation d’un programme C++/CX sur la ligne de commande
• Projets et systèmes de construction
• /MD, , /MT/LD (Utiliser la bibliothèque d’exécution)
• Options du compilateur C/C++
• Options de l’éditeur de liens MSVC
• Outils de build MSVC supplémentaires