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.

Télécharger et installer les outils

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.

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

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.

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.

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 :

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] [-vcvars_ver=vcversion] [spectre_mode]

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 :

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

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 :

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

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

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