Utiliser l’ensemble d’outils Microsoft C++ à partir de la ligne de commande

Vous pouvez générer des applications C et C++ sur la ligne de commande en utilisant les outils inclus dans Visual Studio. L’ensemble d’outils du compilateur Microsoft C++ (MSVC) est également téléchargeable en tant que package autonome. Vous n’avez pas besoin d’installer l’IDE Visual Studio si vous ne prévoyez pas de l’utiliser.

Remarque

Cet article explique comment configurer un environnement pour utiliser les compilateurs individuels, les éditeurs de liens, les bibliothécaires et d’autres outils de base. Le système de génération de projet natif dans Visual Studio, basé sur MSBuild, n’utilise pas l’environnement, comme décrit dans cet article. Pour plus d’informations sur l’utilisation de MSBuild à partir de la ligne de commande, consultez MSBuild sur la ligne de commande - C++.

Télécharger et installer les outils

Si vous avez installé Visual Studio et une charge de travail C++, vous disposez de tous les outils en ligne de commande. Pour plus d’informations sur l’installation de C++ et de Visual Studio, consultez La prise en charge de C++ dans Visual Studio. Si vous souhaitez uniquement l’ensemble d’outils en ligne de commande, téléchargez l’ensemble d’outils de build pour Visual Studio. Lorsque vous exécutez l’exécutable téléchargé, il met à jour et exécute visual Studio Installer. Pour installer uniquement les outils dont vous avez besoin pour le développement C++, sélectionnez le développement Desktop avec la charge de travail C++ . Vous pouvez sélectionner des bibliothèques et ensembles d’outils facultatifs à inclure sous Détails de l’installation. Pour générer du code à l’aide des ensembles d’outils Visual Studio 2015, 2017 ou 2019, sélectionnez les outils de génération MSVC v140, v141 ou v142 facultatifs. Lorsque vous êtes satisfait de vos sélections, choisissez Installer.

Comment utiliser les outils en ligne de commande

Quand vous choisissez l’une des charges de travail C++ dans Visual Studio Installer, l’ensemble d’outils de plateforme Visual Studio est installé. Un ensemble d’outils de plateforme a tous les outils C et C++ pour une version spécifique de Visual Studio. Les outils incluent les compilateurs C/C++, les éditeurs de liens, les assembleurs et d’autres outils de génération, ainsi que les bibliothèques et fichiers d’en-tête correspondants. Vous pouvez utiliser tous ces outils sur la ligne de commande. Ils sont également utilisés en interne par l’IDE Visual Studio. Il existe des compilateurs et des outils hébergés par x86 et x64 distincts pour générer 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.

Pour fonctionner correctement, les outils nécessitent de définir plusieurs variables d’environnement spécifiques. Ces variables permettent d’ajouter les outils au chemin d’accès et de définir 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, la version du Kit de développement logiciel (SDK) Windows et l’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 développeur à l’aide de ces fichiers de commande pour des combinaisons spécifiques d’hôte et de 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. Ils peuvent également être modifiés par les mises à jour ou mises à niveau du produit. 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 installés dépendent du processeur de votre ordinateur et des options que vous avez sélectionnées 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 disposez de 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 peuvent installer ces outils et d’autres outils.

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

Les outils en ligne de commande MSVC utilisent les PATHvariables d’environnement , , LIBTMPINCLUDELIBPATH et utilisent également d’autres variables d’environnement spécifiques à vos outils, plateformes et kits SDK installés. Même une installation simple de Visual Studio peut définir vingt variables d’environnement ou plus. Cette complexité est pourquoi nous vous recommandons vivement d’utiliser un raccourci d’invite de commandes développeur ou l’un des fichiers de commande 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, vous pouvez utiliser la SET commande. Ouvrez une fenêtre d’invite de commandes simple et capturez la sortie de la SET commande pour une ligne de base. Ouvrez une fenêtre d’invite de commandes 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 évidence 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 d’invite de commandes développeur

Les raccourcis d’invite de commandes sont installés dans un dossier Visual Studio spécifique à la version de votre menu Démarrer Windows. Voici la liste des principaux raccourcis d’invite de commandes et des architectures de build prises en charge :

• Invite de commandes développeur : définit l’environnement pour utiliser des outils natifs x86 32 bits pour générer du code natif x86 32 bits.
• Invite de commandes des outils natifs x86 : définit l’environnement pour utiliser des outils natifs x86 32 bits pour générer du code natif x86 32 bits.
• Invite de commandes des outils natifs x64 : définit l’environnement pour utiliser des outils natifs x64 64 bits pour générer du code natif x64 64 bits.
• Invite de commandes des outils croisés x86_x64 : définit l’environnement pour utiliser des outils natifs x86 32 bits pour générer du code natif x64 64 bits.
• Invite de commandes des outils croisés x64_x86 : définit l’environnement pour utiliser des outils natifs x64 64 bits pour générer du code natif x86 32 bits.

Le dossier menu Démarrer et les noms de raccourci varient en fonction de la version installée de Visual Studio. Si vous en définissez un, ils dépendent également du surnom d’installation. Par exemple, supposons que vous avez installé Visual Studio 2022 et que vous lui avez donné un surnom de Latest. Le raccourci de l’invite de commandes développeur est nommé Invite de commandes développeur pour VS 2022 (Dernière version) dans un dossier nommé Visual Studio 2022.

Remarque

Plusieurs outils en ligne de commande ou options d’outil peuvent nécessiter une autorisation d’administrateur. Si vous rencontrez des problèmes d’autorisation lorsque vous les utilisez, nous vous recommandons d’ouvrir la fenêtre d’invite de commandes développeur à l’aide de l’option Exécuter en tant qu’administrateur . Cliquez avec le bouton droit pour ouvrir le menu contextuel de la fenêtre d’invite de commandes, puis choisissez Autres, Exécuter en tant qu’administrateur.

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

1. Sur le bureau, ouvrez le menu Démarrer de Windows. Dans Windows 11, choisissez le bouton Toutes les applications 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) pour votre version de Visual Studio, par exemple, Visual Studio 2022.

2. Dans le dossier, choisissez le raccourci Invite de commandes développeur de votre version de Visual Studio. Ce raccourci ouvre une fenêtre d’invite de commandes développeur qui utilise l’architecture de build par défaut des outils natifs x86 32 bits pour générer du code natif x86 32 bits. Si vous préférez une architecture de build autre que celle par défaut, choisissez l’une des invites de commandes des outils natifs ou croisés pour spécifier l’architecture hôte et cible.

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

Remarque

Par défaut, le répertoire de travail actuel dans une invite de commandes développeur est la racine de votre installation de Visual Studio dans le répertoire Program Files. Il ne s’agit pas d’un emplacement approprié pour votre code et vos projets. Remplacez le répertoire de travail actuel par un autre emplacement avant de créer un projet. L’IDE crée des projets dans votre répertoire utilisateur, généralement dans %USERPROFILE%\source\repos.

Emplacements des fichiers de commande développeur

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

L’emplacement du fichier de commande dépend de la version de Visual Studio que vous avez installée et des choix que vous avez effectués lors de l’installation. Pour Visual Studio 2019, l’emplacement d’installation classique sur un système 64 bits se trouve dans \Program Files\Microsoft Visual Studio\2022\<edition>. Il <edition> peut s’agir de Community, Professional, Enterprise, BuildTools ou d’un autre surnom que vous avez fourni.

Le fichier de commandes de l’invite de commandes du développeur principal, VsDevCmd.batse trouve dans le Common7\Tools sous-répertoire. Quand aucun paramètre n’est spécifié, il définit l’environnement pour utiliser les outils natifs x86 pour générer du code x86 32 bits.

D’autres fichiers de commandes sont disponibles pour configurer des architectures de build spécifiques. Les fichiers de commandes disponibles dépendent des charges de travail et des options Visual Studio que vous avez installées. Dans Visual Studio 2017 et Visual Studio 2019, vous les trouverez dans le sous-répertoire VC\Auxiliaire\Build.

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

Fichier de commandes	Architectures hôte et cible
vcvars32.bat	Utilisent les outils natifs x86 32 bits pour générer du code x86 32 bits.
vcvars64.bat	Utilisent les outils natifs x64 64 bits pour générer du code x64 64 bits.
vcvarsx86_amd64.bat	Utilisent les outils croisés natifs x86 32 bits pour générer du code x64 64 bits.
vcvarsamd64_x86.bat	Utilisent les outils croisés natifs x64 64 bits pour générer du code x86 32 bits.
vcvarsx86_arm.bat	Utilisent les outils croisés natifs x86 32 bits pour générer du code ARM.
vcvarsamd64_arm.bat	Utilisent les outils croisés natifs x64 64 bits pour générer du code ARM.
vcvarsx86_arm64.bat	Utilisez les outils croisés natifs x86 32 bits pour générer du code ARM64.
vcvarsamd64_arm64.bat	Utilisez les outils croisés natifs x64 64 bits pour générer du code ARM64.
vcvarsall.bat	Utilisez des paramètres pour spécifier les architectures hôtes et cibles, le Kit de développement logiciel (SDK) Windows et les choix de plateforme. Pour obtenir la liste des options prises en charge, appelez à l’aide d’un /help paramètre.

Attention

Le vcvarsall.bat fichier et d’autres fichiers de commande Visual Studio peuvent varier d’un ordinateur à l’autre. Ne remplacez pas un fichier manquant ou endommagé à vcvarsall.bat l’aide d’un fichier d’un autre ordinateur. Réexécutez le programme d’installation de Visual Studio pour remplacer le fichier manquant.

Le vcvarsall.bat fichier varie également d’une version à l’autre. Si la version actuelle de Visual Studio est installée sur un ordinateur doté d’une version antérieure de Visual Studio, n’exécutez vcvarsall.bat pas ou un autre fichier de commandes Visual Studio à partir de différentes versions dans la même fenêtre d’invite de commandes.

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. Permet vcvarsall.bat de définir des variables d’environnement pour configurer la ligne de commande pour la compilation native 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 les plateformes Microsoft Store, plateforme Windows universelle ou Windows Desktop. Vous pouvez même spécifier le Kit de développement logiciel (SDK) Windows à utiliser, puis sélectionner la version de l’ensemble d’outils de plateforme.

Lorsqu’elles sont utilisées sans argument, vcvarsall.bat configure les variables d’environnement pour utiliser le compilateur x86 natif actuel pour les cibles windows Desktop 32 bits. Vous pouvez ajouter des arguments pour configurer l’environnement afin d’utiliser l’un des outils natifs ou croisés du compilateur. vcvarsall.bat affiche un message d’erreur si vous spécifiez une configuration qui n’est pas installée ou non disponible sur votre ordinateur.

Syntaxe de vcvarsall

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

architecture
Cet argument facultatif spécifie l’architecture hôte et cible à utiliser. Si l’architecture n’est pas spécifiée, l’environnement de build par défaut est utilisé. Ces arguments 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 vous permet de spécifier store ou uwp en tant que 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, le dernier SDK Windows installé est utilisé. Pour spécifier la version du Kit de développement logiciel (SDK) Windows, vous pouvez utiliser un numéro complet du Kit de développement logiciel (SDK) Windows, tel que 10.0.10240.0, ou spécifier 8.1 pour utiliser le SDK Windows 8.1.

vcversion
Spécifie éventuellement l’ensemble d’outils du compilateur Visual Studio à utiliser. Par défaut, l’environnement est défini pour utiliser l’ensemble d’outils du compilateur Visual Studio actuel.

Utilisez -vcvars_ver=14.2x.yyyyy pour spécifier une version spécifique de l’ensemble d’outils du compilateur Visual Studio 2019.

Utilisez -vcvars_ver=14.29 pour spécifier la dernière version de l’ensemble d’outils du compilateur Visual Studio 2019.

Utilisez -vcvars_ver=14.0 pour spécifier l’ensemble d’outils du compilateur Visual Studio 2015.

spectre_mode
Laissez ce paramètre hors service pour utiliser des bibliothèques sans atténuations de Spectre. Utilisez la valeur spectre pour utiliser des bibliothèques avec des atténuations spectre.

Pour configurer l’environnement de build dans une fenêtre d’invite de commandes existante

1. À l’invite de commandes, utilisez la commande CD pour accéder au répertoire d’installation de Visual Studio. Ensuite, réutilisez CD pour accéder au sous-répertoire qui contient les fichiers de commandes propres à la configuration. Pour Visual Studio 2019 et Visual Studio 2017, utilisez le sous-répertoire VC\Auxiliaire\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 dernier kit de développement logiciel (SDK) Windows et de l’ensemble d’outils du compilateur Visual Studio, utilisez cette ligne de commande :

   vcvarsall.bat amd64_arm uwp

Créer votre propre raccourci d’invite de commandes

Ouvrez la boîte de dialogue Propriétés d’un raccourci d’invite de commandes développeur pour afficher la cible de commande utilisée. Par exemple, la cible du raccourci Invite de commandes des outils natifs x64 pour VS 2019 ressemble à ceci :

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.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 batch que vous le feriez 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. Par exemple, voici un raccourci pour générer du code ARM pour UWP sur une plateforme 64 bits, à l’aide du dernier KIT de développement logiciel (SDK) Windows. Pour utiliser un ensemble d’outils de compilateur antérieur, spécifiez le numéro de version. Utilisez quelque chose comme la cible de cette commande dans votre raccourci :

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

Ajustez le chemin d’accès pour refléter votre répertoire d’installation de Visual Studio. Le fichier vcvarsall.bat comporte des informations supplémentaires sur les numéros de versions 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 les fichiers de code source dans les applications, les bibliothèques et les DLL.

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

Lorsque vous générez sur la ligne de commande, la commande F1 n’est pas disponible pour obtenir de 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, l’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 devenv commande pour utiliser Visual Studio pour générer des projets et des solutions. Visual Studio prend également en charge les systèmes de génération 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 l’IDE Visual Studio. Cela équivaut à exécuter la commande Build project ou Build Solution dans l’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 l’IDE Visual Studio.

CMake
CMake (cmake.exe) est un outil multiplateforme open source 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.

Remarque

À compter de Visual Studio 2019 version 16.5, MSBuild et DEVENV n’utilisent pas l’environnement de ligne de commande pour contrôler l’ensemble d’outils et les bibliothèques utilisés.

Contenu de cette section

Ces articles montrent comment créer des applications sur la ligne de commande et décrire comment personnaliser l’environnement de génération de ligne de commande. Certains montrent comment utiliser des ensembles d’outils 64 bits et cibler des plateformes x86, x64, ARM et ARM64. Ils décrivent également l’utilisation des outils de génération de ligne de commande MSBuild et NMAKE.

Procédure pas à pas : compilation d’un programme C++ natif sur la ligne de commande
Donne un exemple qui montre comment créer et compiler un programme C++ sur la ligne de commande.

Procédure pas à pas : compiler un programme C sur la ligne de commande
Décrit comment compiler un programme écrit dans le langage de programmation C.

Procédure pas à pas : compilation d’un programme C++/CLI sur la ligne de commande
Décrit comment créer et compiler un programme C++/CLI qui utilise le .NET Framework.

Procédure pas à pas : compilation d’un programme C++/CX sur la ligne de commande
Décrit comment créer et compiler un programme C++/CX qui utilise le Windows Runtime.

Informations de référence sur NMAKE
Fournit des liens vers des articles qui décrivent l'utilitaire Microsoft Program Maintenance Utility (NMAKE.EXE).

MSBuild sur la ligne de commande – C++
Fournit des liens vers des articles qui expliquent comment utiliser msbuild.exe à partir de la ligne de commande.

Sections connexes

/MD, /MT, /LD (Utiliser la bibliothèque d’exécution)
Décrit comment utiliser ces options de compilateur pour utiliser une bibliothèque runtime Debug ou Release.

Options du compilateur C/C++
Fournit des liens vers des articles qui présentent les options de compilateur C et C++, ainsi que CL.exe.

Options de l’éditeur de liens MSVC
Fournit des liens vers des articles qui présentent les options de l'éditeur de liens et LINK.exe.

Outils de build MSVC supplémentaires
Fournit des liens vers des outils de build C/C++ inclus dans Visual Studio.

Voir aussi

Projets et systèmes de build