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.

Remarque

Cet article explique comment configurer un environnement pour utiliser les compilateurs individuels, les éditeurs de liens, les bibliothèques 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 Installer 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 en ligne de commande Build Tools pour Visual Studio. Sur la page des téléchargements, développez Outils pour Visual Studio pour trouver le téléchargement des Outils de build. Lorsque vous exécutez l’exécutable téléchargé, il met à jour et exécute le programme d’installation Visual Studio.

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++ . Sous Détails de l’installation, vous pouvez sélectionner des bibliothèques et ensembles d’outils facultatifs. Pour générer du code à l’aide des ensembles d’outils Visual Studio 2015, Visual Studio 2017 ou Visual Studio 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

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. Pour les versions ultérieures de Visual Studio, le package se compose de la version MSVC (format de version v##.###), qui inclut tous les outils C et C++ pour ce package MSVC particulier. La version MSVC est découplée de la version Visual Studio.

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.

Pour fonctionner correctement, 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 à l’aide de ces fichiers de commandes pour des combinaisons précises 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. 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 spécifique à la version de votre menu Démarrer 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 natifs 32 bits et x86 pour générer du code natif 32 bits et x86.
• Invite de commandes des outils natifs x86. Définit l’environnement pour utiliser des outils natifs 32 bits et x86 pour générer du code natif 32 bits et x86.
• Invite de commandes des outils natifs x64. Définit l’environnement pour utiliser des outils 64 bits et x64 natifs pour générer du code 64 bits x64 natif.
• x86_x64 invite de commandes Cross Tools. Définit l’environnement pour utiliser des outils natifs x86 32 bits afin de générer du code natif x64 64 bits.
• x64_x86 invite de commandes Cross Tools. Configure l’environnement pour utiliser des outils natifs x64 64 bits afin de générer du code natif x86 32 bits.

Le dossier du menu Démarrer et les noms de raccourcis 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 d’invite de commandes développeur est nommé Developer Command Prompt for VS 2022 (Latest) dans un dossier nommé Visual Studio 2022.

Remarque

Plusieurs outils en ligne de commande ou options d’outil nécessitent des privilèges 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 du 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 Plus>Exécuter en tant qu’administrateur.

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) pour votre version de Visual Studio, par exemple Visual Studio 2022.

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 développeur qui utilise l’architecture de génération par défaut des outils x86 natifs 32 bits pour générer du code x86 natif 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é.

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. Cet emplacement n’est pas 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 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.

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

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 options Visual Studio que vous avez installées. Dans Visual Studio 2017 et Visual Studio 2019, vous les trouvez dans le répertoire VC\Auxiliary\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 commande :

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	Utilisez les outils croisés natifs x64 64 bits pour construire 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	Utilisez les outils croisés natifs 64 bits x64 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ôte et cible, Windows SDK et les choix de plateforme. Pour obtenir la liste des options prises en charge, appelez en utilisant un paramètre /help.

Attention

Le fichier vcvarsall.bat et d’autres fichiers de commande Visual Studio peuvent varier d’un ordinateur à l’autre. Ne remplacez pas un fichier vcvarsall.bat manquant ou endommagé en utilisant un fichier provenant d’un autre ordinateur. Réexécutez le programme d’installation 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 pas vcvarsall.bat ou un autre fichier de commandes Visual Studio 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. 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 est défini pour utiliser l’ensemble d’outils du compilateur Visual Studio actuel.

  Utilisez -vcvars_ver=14.2x.aaaa 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 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. Ensuite, utilisez CD à nouveau pour passer au sous-répertoire qui contient les fichiers de commande spécifiques à la configuration. Pour Visual Studio 2019 et Visual Studio 2017, 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

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

%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 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. Par exemple, voici un raccourci pour générer du code ARM pour UWP sur une plateforme 64 bits, à l'aide du dernier sdk Windows. Pour utiliser un ensemble d’outils de compilateur antérieur, spécifiez le numéro de version. Utilisez une commande telle que cette cible de 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 Visual Studio. Le vcvarsall.bat fichier contient des informations supplémentaires 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.

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

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