Uso del conjunto de herramientas de Microsoft C++ desde la línea de comandos

Con las herramientas incluidas en Visual Studio, puede compilar aplicaciones de C y C++ en la línea de comandos. El conjunto de herramientas del compilador de Microsoft C++ (MSVC) también se puede descargar como un paquete independiente. No es necesario instalar el IDE de Visual Studio si no tiene previsto usarlo.

Nota:

En este artículo se explica cómo configurar un entorno para usar los compiladores individuales, los enlazadores, el bibliotecario y otras herramientas básicas. El sistema de creación de proyectos nativo en Visual Studio, basado en MSBuild, no usa el entorno como se indica en este artículo. Para obtener más información sobre cómo usar MSBuild en la línea de comandos, vea MSBuild en la línea de comandos: C++.

Descarga e instalación de las herramientas

Si ha instalado Visual Studio y una carga de trabajo de C++, tiene todas las herramientas de línea de comandos. Para obtener información sobre cómo instalar C++ y Visual Studio, vea Instalación de compatibilidad con C++ en Visual Studio. Si solo le interesa el conjunto de herramientas de línea de comandos, descargue las herramientas de compilación para Visual Studio. Cuando ejecute el archivo ejecutable que se ha descargado, este actualizará y ejecutará el Instalador de Visual Studio. Para instalar solo las herramientas que necesita para el desarrollo de C++, seleccione la carga de trabajo Desarrollo para el escritorio con C++. En Detalles de la instalación, puede seleccionar bibliotecas y conjuntos de herramientas opcionales para incluirlos. Para compilar código mediante los conjuntos de herramientas de Visual Studio 2015, 2017 o 2019, seleccione las herramientas de compilación opcionales MSVC v140, v141 o v142. Cuando esté satisfecho con lo que ha seleccionado, haga clic en Instalar.

Cómo usar las herramientas de línea de comandos

Al elegir una de las cargas de trabajo de C++ en el Instalador de Visual Studio, instala el conjunto de herramientas de la plataforma Visual Studio. Un conjunto de herramientas de la plataforma tiene todas las herramientas de C y C++ para una versión específica de Visual Studio. Entre las herramientas se incluyen compiladores de C/C++, enlazadores, ensambladores y otras herramientas de compilación, y las bibliotecas y archivos de encabezado correspondientes. Puede usar todas estas herramientas en la línea de comandos. También las usa internamente el IDE de Visual Studio. Existen compiladores independientes hospedados en x86 y x64, y herramientas para compilar código para destinos como x86, x64, ARM y ARM64. Cada conjunto de herramientas para una arquitectura de compilación de destino y de host en particular se almacena en su propio directorio.

Para que las herramientas funcionen correctamente, es necesario especificar varias variables específicas del entorno. Estas variables se usan para agregar las herramientas a la ruta de acceso y establecer las ubicaciones de los archivos, archivos de biblioteca y el SDK incluidos. Para que sea fácil establecer estas variables de entorno, el instalador crea archivos de comandos personalizados, o archivos por lotes, durante la instalación. Puede ejecutar uno de estos archivos de comandos para establecer una arquitectura de compilación de host y de destino específica, la versión del SDK de Windows y el conjunto de herramientas de la plataforma. Para mayor comodidad, el instalador también crea accesos directos en el menú Inicio. Los accesos directos abren ventanas del símbolo del sistema para desarrolladores mediante estos archivos de comandos para combinaciones específicas de host y destino. Estos métodos abreviados garantizan que todas las variables de entorno necesarias estén establecidas y listas para su uso.

Las variables de entorno necesarias corresponden específicamente a su instalación y a la arquitectura de compilación que elija. Además, podrían cambiar con las actualizaciones del producto. Esta variabilidad es una razón por la que se recomienda que use un archivo de comandos o un acceso directo del símbolo del sistema instalado, en lugar de establecer las variables de entorno por su cuenta.

Los conjuntos de herramientas, los archivos de comandos y los accesos directos instalados dependen del procesador del equipo y de las opciones seleccionadas durante la instalación. Las herramientas hospedadas en x86 y las herramientas cruzadas que compilan código x86 y x64 siempre están instaladas. Si tiene Windows de 64 bits, también están instaladas las herramientas hospedadas en x64 y las herramientas cruzadas que compilan código x86 y x64. Si opta por las herramientas opcionales de la Plataforma universal de Windows de C++, también se instalan las herramientas x86 y x64 que compilan código ARM y ARM64. Otras cargas de trabajo pueden instalar estas y otras herramientas.

Rutas de acceso y variables de entorno para compilaciones de línea de comandos

Las herramientas de línea de comandos de MSVC emplean las variables de entorno PATH, TMP, INCLUDE, LIB y LIBPATH, así como otras variables de entorno específicas de las herramientas, plataformas y SDK instalados. Incluso una sencilla instalación de Visual Studio puede establecer veinte o más variables de entorno. Debido a esta dificultad, se recomienda encarecidamente usar un acceso directo del símbolo del sistema para desarrolladores o uno de los archivos de comandos personalizados. No se recomienda establecer estas variables en el entorno Windows manualmente.

Para ver qué variables de entorno se establecen mediante un acceso directo del símbolo del sistema para desarrolladores, puede usar el comando SET. Abra una ventana del símbolo del sistema convencional y capture la salida del comando SET para una línea base. Abra una ventana del símbolo del sistema para desarrolladores y capture la salida del comando SET para comparar. Use una herramienta de comparación como la que está integrada en Visual Studio para destacar las variables de entorno que establece el símbolo del sistema para desarrolladores. Para más información sobre las variables de entorno del compilador y el enlazador, consulte Variables de entorno de CL.

Accesos directos del símbolo del sistema para desarrolladores

Los accesos directos del símbolo del sistema se instalan en una carpeta específica de la versión de Visual Studio en el menú Inicio de Windows. Esta es una lista de los accesos directos básicos del símbolo del sistema y las arquitecturas de compilación que admiten:

• Símbolo del sistema para desarrolladores: configura el entorno para usar herramientas nativas x86 de 32 bits para compilar código nativo x86 de 32 bits.
• Símbolo del sistema de las herramientas nativas x86: configura el entorno para usar herramientas nativas x86 de 32 bits para compilar código nativo x86 de 32 bits.
• Símbolo del sistema de las herramientas nativas x64: configura el entorno para usar herramientas nativas x64 de 64 bits para compilar código nativo x64 de 64 bits.
• Símbolo del sistema de las herramientas cruzadas x86_x64: configura el entorno para usar herramientas nativas x86 de 32 bits para compilar código nativo x64 de 64 bits.
• Símbolo del sistema de las herramientas cruzadas x64_x86: configura el entorno para usar herramientas nativas x64 de 64 bits para compilar código nativo x86 de 32 bits.

La carpeta del menú Inicio y los nombres de acceso directo varían en función de la versión instalada de Visual Studio. También dependen del alias de la instalación, si configuró uno. Por ejemplo, supongamos que ha instalado Visual Studio 2022 y que le ha asignado el alias Más reciente. El acceso directo del símbolo del sistema para desarrolladores se denominará Símbolo del sistema para desarrolladores de VS 2022 (más reciente), en una carpeta llamada Visual Studio 2022.

Nota:

Hay varias herramientas de línea de comandos u opciones de herramientas que podrían requerir el permiso de administrador. Si tiene problemas de permisos al usarlas, le recomendamos que abra la ventana del símbolo del sistema para desarrolladores mediante la opción Ejecutar como administrador. Haga clic con el botón derecho para abrir el menú contextual de la ventana del símbolo del sistema y elija Más, Ejecutar como administrador.

Para abrir una ventana del símbolo del sistema para desarrolladores

1. En el escritorio, abra el menú Inicio de Windows. En Windows 11, elija el botón Todas las aplicaciones para abrir la lista de aplicaciones instaladas. En Windows 10, la lista se abre a la izquierda. Desplácese hacia abajo en la lista para buscar y abrir la carpeta (no la aplicación) de la versión de Visual Studio, por ejemplo, Visual Studio 2022.

2. En la carpeta, elija Símbolo del sistema para desarrolladores de su versión de Visual Studio. Este acceso directo inicia una ventana del símbolo del sistema para desarrolladores que usa las herramientas nativas x86 de la arquitectura de compilación predeterminada de 32 bits para compilar código nativo x86 de 32 bits. Si prefiere una arquitectura de compilación no predeterminada, elija uno de los símbolos del sistema de herramientas nativas o cruzadas para especificar la arquitectura de host y de destino.

Una manera aún más rápida de abrir un símbolo del sistema para desarrolladores consiste en escribir símbolo del sistema para desarrolladores en el cuadro de búsqueda del escritorio. Después, elija el resultado que quiera.

Nota:

De forma predeterminada, el directorio de trabajo actual en un símbolo del sistema para desarrolladores es la raíz de la instalación de Visual Studio en el directorio Archivos de programa. Esta no es una ubicación adecuada para el código y los proyectos. Cambie el directorio de trabajo actual a otra ubicación antes de crear un proyecto. El IDE crea proyectos en el directorio de usuario, normalmente en %USERPROFILE%\source\repos.

Ubicaciones del archivo de comandos para desarrolladores

Si prefiere configurar el entorno de compilación en una ventana del símbolo del sistema existente, puede usar uno de los archivos de comandos creado por el instalador. Le recomendamos que establezca el entorno en una nueva ventana del símbolo del sistema. Se desaconseja cambiar más adelante los entornos en la misma ventana de comandos.

La ubicación de los archivos de comandos depende de la versión de Visual Studio que haya instalado y de las decisiones que haya tomado durante la instalación. En el caso de Visual Studio 2019, la ubicación de instalación típica en un sistema de 64 bits está en \Program Files\Microsoft Visual Studio\2022\<edition>. La <edition> puede ser Community, Professional, Enterprise, BuildTools u otro alias proporcionado.

El archivo de comandos principal del símbolo del sistema para desarrolladores, VsDevCmd.bat, se encuentra en el subdirectorio Common7\Tools. Cuando no se especifica ningún parámetro, se establece el entorno para usar las herramientas nativas x86 para compilar código x86 de 32 bits.

Hay más archivos de comandos disponibles para configurar arquitecturas de compilación específicas. Los archivos de comandos disponibles dependen de las cargas de trabajo y las opciones de Visual Studio que haya instalado. En Visual Studio 2017 y Visual Studio 2019, los encontrará en el subdirectorio VC\Auxiliary\Build.

Estos archivos de comandos establecen los parámetros predeterminados y llaman a VsDevCmd.bat para configurar el entorno de arquitectura de compilación especificada. Una instalación típica puede incluir estos archivos de comandos:

Archivo de comandos	Arquitecturas de host y de destino
vcvars32.bat	Usa las herramientas nativas x86 de 32 bits para compilar código x86 de 32 bits.
vcvars64.bat	Usa las herramientas nativas x64 de 64 bits para compilar código x64 de 64 bits.
vcvarsx86_amd64.bat	Usa las herramientas nativas x86 de 32 bits para compilar código x64 de 64 bits.
vcvarsamd64_x86.bat	Usa las herramientas cruzadas nativas x64 de 64 bits para compilar código x86 de 32 bits.
vcvarsx86_arm.bat	Usa las herramientas nativas x86 de 32 bits para compilar código ARM.
vcvarsamd64_arm.bat	Usa las herramientas cruzadas nativas x64 de 64 bits para compilar código ARM.
vcvarsx86_arm64.bat	Usa las herramientas nativas x86 de 32 bits para compilar código ARM64.
vcvarsamd64_arm64.bat	Usa las herramientas nativas x64 de 64 bits para compilar código ARM64.
vcvarsall.bat	Usa parámetros para especificar las arquitecturas de host y de destino, el SDK de Windows y las opciones de plataforma. Para obtener una lista de las opciones admitidas, realice una llamada mediante el parámetro /help.

Precaución

El archivo vcvarsall.bat y otros archivos de comandos de Visual Studio pueden variar de un equipo a otro. Si el archivo vcvarsall.bat o está dañado, no lo reemplace por un archivo de otro equipo. Vuelva a ejecutar el instalador de Visual Studio para reemplazar el archivo que falta.

El archivo vcvarsall.bat también puede variar de una versión a otra. Si se instala la versión actual de Visual Studio en un equipo que también tiene una versión anterior de Visual Studio, no ejecute vcvarsall.bat ni cualquier otro archivo de comandos de Visual Studio de versiones diferentes en la misma ventana del símbolo del sistema.

Usar las herramientas de desarrollo en una ventana de comandos existente

La manera más sencilla de especificar una arquitectura de compilación determinada en una ventana de comandos existente consiste en usar el archivo vcvarsall.bat. Use vcvarsall.bat para establecer las variables de entorno con el fin de configurar la línea de comandos para la compilación nativa de 32 bits o de 64 bits. Los argumentos permiten especificar la compilación cruzada en procesadores x86, x64, ARM o ARM64. Puede establecer como destino Microsoft Store, la Plataforma universal de Windows o las plataformas de escritorio de Windows. Incluso puede especificar qué SDK de Windows se va a usar y seleccionar la versión del conjunto de herramientas de la plataforma.

Cuando se usa sin argumentos, vcvarsall.bat configura las variables de entorno para usar el compilador nativo x86 actual para los destinos de Escritorio de Windows de 32 bits. Puede agregar argumentos para configurar el entorno de modo que use cualquiera de las herramientas de compilador nativo o cruzado. vcvarsall.bat muestra un mensaje de error si especifica una configuración que no está instalada o disponible en el equipo.

Sintaxis de vcvarsall

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

architecture
Este argumento opcional especifica la arquitectura de host y de destino que se van a usar. Si no se especifica architecture, se usa el entorno de compilación predeterminado. Se admiten estos argumentos:

architecture	Compilador	Arquitectura del equipo host	Arquitectura de salida de compilación (destino)
x86	x86 nativo de 32 bits	x86, x64	x86
x86_amd64 o x86_x64	x64 en x86 cruzado	x86, x64	x64
x86_arm	ARM en x86 cruzado	x86, x64	ARM
x86_arm64	ARM64 en x86 cruzado	x86, x64	ARM64
amd64 o x64	x64 nativo de 64 bits	x64	x64
amd64_x86 o x64_x86	x86 en x64 cruzado	x64	x86
amd64_arm o x64_arm	ARM en x64 cruzado	x64	ARM
amd64_arm64 o x64_arm64	ARM64 en x64 cruzado	x64	ARM64

platform_type
Este argumento opcional permite especificar store o uwp como el tipo de plataforma. De forma predeterminada, el entorno se configura para compilar aplicaciones de escritorio o de consola.

winsdk_version
Especifica, de manera opcional, la versión de Windows SDK que se va a usar. De forma predeterminada, se usa el Windows SDK que se ha instalado más recientemente. Para especificar la versión de Windows SDK, puede usar un número completo de Windows SDK, como 10.0.10240.0, o especificar 8.1 para usar el SDK de Windows 8.1.

vcversion
Especifica, de manera opcional, el conjunto de herramientas del compilador de Visual Studio que se van a usar. De forma predeterminada, se configura el entorno para usar el conjunto de herramientas del compilador de Visual Studio actual.

Use -vcvars_ver=14.2x.yyyyy para especificar una versión determinada del conjunto de herramientas del compilador de Visual Studio 2019.

Use -vcvars_ver=14.29 para especificar la última versión del conjunto de herramientas del compilador de Visual Studio 2019.

Use -vcvars_ver=14.0 para especificar el conjunto de herramientas del compilador de Visual Studio 2015.

spectre_mode
Deje este parámetro fuera para usar bibliotecas sin mitigaciones de Spectre. Use el valor spectre para utilizar bibliotecas con mitigaciones de Spectre.

Para configurar el entorno de compilación en una ventana del símbolo del sistema existente

1. En el símbolo del sistema, use el comando CD para cambiar al directorio de instalación de Visual Studio. Después, vuelva a usar CD para cambiar al subdirectorio que contiene los archivos de comandos específicos de la configuración. Para Visual Studio 2019 y Visual Studio 2017, use el subdirectorio VC\Auxiliary\Build. Para Visual Studio 2015, use el subdirectorio VC.

2. Escriba el comando para el entorno de desarrollo preferido. Por ejemplo, para compilar código ARM para UWP en una plataforma de 64 bits mediante la versión más reciente del SDK de Windows y del conjunto de herramientas del compilador de Visual Studio, use esta línea de comandos:

   vcvarsall.bat amd64_arm uwp

Crear su propio acceso directo del símbolo del sistema

Abra el cuadro de diálogo Propiedades para un acceso directo del símbolo del sistema para desarrolladores para ver el destino del comando usado. Por ejemplo, el destino del acceso directo Símbolo del sistema de las herramientas nativas x64 para VS 2019 es algo parecido a esto:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

Los archivos por lotes específicos de la arquitectura establecen el parámetro architecture y llaman a vcvarsall.bat. Puede pasar las mismas opciones a estos archivos por lotes, del mismo modo que los pasa a vcvarsall.bat, o puede simplemente llamar a vcvarsall.bat directamente. Para especificar parámetros para su propio acceso directo de comandos, agréguelos al final del comando con comillas dobles. Por ejemplo, este es un acceso directo para compilar código ARM para UWP en una plataforma de 64 bits, con la versión más reciente del SDK de Windows. Para usar un conjunto anterior de herramientas del compilador, especifique el número de versión. Use algo parecido a este destino de comando en el acceso directo:

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

Ajuste la ruta de acceso para reflejar el directorio de instalación de Visual Studio. El archivo vcvarsall.bat tiene información adicional sobre los números de versión específicos.

Herramientas de línea de comandos

Para compilar un proyecto de C/C++ en el símbolo del sistema, Visual Studio proporciona estas herramientas de línea de comandos:

CL
Utilice el compilador (cl.exe) para compilar y vincular archivos de código fuente en aplicaciones, bibliotecas y DLL.

Link
Utilice el enlazador (link.exe) para vincular bibliotecas y archivos de objeto compilados en aplicaciones y DLL.

Cuando se compila en la línea de comandos, el comando F1 no está disponible para obtener ayuda instantánea. En su lugar, puede usar un motor de búsqueda para obtener información sobre advertencias, errores y mensajes. También puede descargar y usar los archivos de ayuda sin conexión. Para usar la búsqueda en Microsoft Learn, escriba la consulta en el cuadro de búsqueda de la parte superior de cualquier artículo.

Herramientas de administración de proyectos de línea de comandos

De forma predeterminada, el IDE de Visual Studio usa sistemas de compilación de proyectos nativos basados en MSBuild. Puede invocar a MSBuild directamente para compilar proyectos sin usar el IDE. También puede usar el comando devenv para usar Visual Studio para compilar proyectos y soluciones. Además, Visual Studio admite sistemas de compilación basados en CMake o NMake.

MSBuild
Use MSBuild (msbuild.exe) y un archivo de proyecto (.vcxproj) para configurar una compilación e invocar el conjunto de herramientas sin cargar el IDE de Visual Studio. Equivale a ejecutar el proyecto Build o el comando Build Solution en el IDE de Visual Studio. MSBuild tiene ventajas sobre el IDE al compilar en la línea de comandos. No tiene que instalar el IDE completo en todos los servidores de compilación ni en las canalizaciones de compilación. Se evita la sobrecarga adicional del IDE. MSBuild se ejecuta en entornos de compilación en contenedores y admite un registrador binario.

DEVENV
Use DEVENV (devenv.exe) combinado con un modificador de la línea de comandos, como /Build o /Clean, para ejecutar determinados comandos de compilación sin mostrar el IDE de Visual Studio.

CMake
CMake (cmake.exe) es una herramienta de código abierto multiplataforma para definir procesos de compilación que se ejecutan en varias plataformas. CMake puede configurar y controlar herramientas de compilación nativas para sus plataformas compatibles, como MSBuild y Make. Para obtener más información sobre CMake, vea la documentación de CMake.

NMAKE
Use NMAKE (nmake.exe) para compilar proyectos de C++ mediante un archivo Make tradicional.

Nota:

A partir de la versión 16.5 de Visual Studio 2019, MSBuild y DEVENV no usan el entorno de línea de comandos para controlar el conjunto de herramientas y las bibliotecas utilizadas.

En esta sección

En estos artículos se muestra cómo compilar aplicaciones en la línea de comandos y se describe cómo personalizar el entorno de compilación de la línea de comandos. En algunos de ellos se indica cómo usar conjuntos de herramientas de 64 bits y cómo establecer como destino plataformas x86, x64, ARM y ARM64. También se describe el uso de las herramientas de compilación de línea de comandos MSBuild y NMAKE.

Tutorial: Compilar un programa nativo de C++ en la línea de comandos
Ofrece un ejemplo que muestra cómo crear y compilar un programa de C++ en la línea de comandos.

Tutorial: Compilar un programa escrito en C en la línea de comandos
Describe cómo compilar un programa escrito en el lenguaje de programación C.

Tutorial: Compilación de un programa de C++/CLI en la línea de comandos
Describe cómo crear y compilar un programa de C++/CLI que utilice .NET Framework.

Tutorial: Compilar un programa de C++/CX en la línea de comandos
Describe cómo crear y compilar un programa de C++/CX que utilice Windows en tiempo de ejecución.

Referencia de NMAKE
Proporciona vínculos a artículos que describen la Utilidad de mantenimiento de programas de Microsoft (NMAKE.EXE).

MSBuild en la línea de comandos - C++
Proporciona vínculos a artículos en los que se explica cómo usar msbuild.exe desde la línea de comandos.

Secciones relacionadas

/MD, /MT, /LD (usar la biblioteca en tiempo de ejecución)
Describe cómo utilizar estas opciones del compilador para usar una biblioteca en tiempo de ejecución Debug o Release.

Opciones del compilador de C/C++
Proporciona vínculos a artículos en los que se explican las opciones del compilador de C y C++, y CL.exe.

Opciones del enlazador MSVC
Proporciona vínculos a artículos en los que se explican las opciones del enlazador y LINK.exe.

Herramientas de generación MSVC adicionales
Proporciona vínculos a las herramientas de compilación de C/C++ que se incluyen en Visual Studio.

Consulte también

Proyectos y sistemas de compilación