Configuración del proyecto para una configuración de depuración de C++Project settings for a C++ debug configuration

Puede cambiar la configuración del proyecto para una configuración de depuración de C o Visual C++ en el páginas de propiedades cuadro de diálogo, como se describe en Cómo: Set Debug y Release Configurations.You can change the project settings for a C or Visual C++ debug configuration in the Property Pages dialog box, as discussed in How to: Set Debug and Release Configurations. Las siguientes tablas muestran dónde encontrar valores relacionados con el depurador en el páginas de propiedades cuadro de diálogo.The following tables show where to find debugger-related settings in the Property Pages dialog box.

Advertencia

La configuración de proyecto de depuración en el propiedades de configuración y depuración categoría para las aplicaciones UWP y componentes que se escriben en C++ son diferentes.The debug project settings in the Configuration Properties/Debugging category for UWP apps and components that are written in C++ are different. Vea inicie una sesión de depuración (VB, C#, C++ y XAML).See Start a debug session (VB, C#, C++ and XAML).

Especifique el depurador para usar en el depurador para iniciar cuadro de lista.Specify which debugger to use in the Debugger to launch list box. La opción determinará qué propiedades serán visibles.Your choice will affect which properties are visible.

Cada vez que guarda la solución, la configuración de depuración se escribe y se guarda automáticamente en un archivo "de usuario" (.vcxproj.user).Each debug property setting is automatically written and saved to the "per-user" file (.vcxproj.user) for your solution whenever you save your solution.

Carpeta Propiedades de configuración (categoría Depuración)Configuration Properties folder (Debugging category)

Configuración deSetting DescripciónDescription
Depurador para iniciarDebugger to launch Especifica el depurador que se va a ejecutar, con las opciones siguientes:Specifies the debugger to run, with the following choices:

- Depurador local de Windows- Local Windows Debugger
- Depurador remoto de Windows- Remote Windows Debugger
- Depurador de explorador Web- Web Browser Debugger
- Depurador de servicio Web- Web Service Debugger
Comando (depurador Local de Windows)Command (Local Windows Debugger) Especifica el comando usado para iniciar el programa que se está depurando en el equipo local.Specifies the command for starting the program that you are debugging on the local computer.
Comando remoto (depurador remoto de Windows)Remote Command (Remote Windows Debugger) La ruta de acceso al archivo .exe en el equipo remoto.The path for the .exe on the remote computer. Escriba la ruta de acceso como lo haría en el equipo remoto.Enter the path just as you would enter it on the remote machine.
Argumentos de comando (depurador Local de Windows y depurador remoto de Windows)Command Arguments (Local Windows Debugger and Remote Windows Debugger) -Especifica los argumentos del comando especificado anteriormente.- Specifies arguments for the command specified earlier.

Puede utilizar los siguientes operadores de redirección en este cuadro:You can use the following redirection operators in this box:

< file
Lee stdin del archivo.Reads stdin from file.

> file
Escribe stdout en el archivo.Writes stdout to file.

>> file
Agrega stdout al archivo.Appends stdout to file.

2> file2> file
Escribe stderr en el archivo.Writes stderr to file.

2>> file2>> file
Agrega stderr al archivo.Appends stderr to file.

2> &12> &1
Envía el resultado de stderr (2) a la misma posición que stdout (1).Sends stderr (2) output to same location as stdout (1).

1> &21> &2
Envía el resultado de stdout (1) a la misma posición que stderr (2).Sends stdout (1) output to same location as stderr (2).

En la mayoría de los casos, estos operadores solo pueden utilizarse en aplicaciones de consola.In most cases, these operators are applicable only to console applications.
Directorio de trabajoWorking Directory Especifica el directorio de trabajo del programa que se está depurando en relación con el directorio del proyecto en el que se encuentra el archivo EXE.Specifies the working directory of the program being debugged, relative to the project directory where your EXE is located. Si lo deja en blanco, el directorio de trabajo será el directorio del proyecto.If you leave this blank, the working directory is the project directory. Para la depuración remota, el directorio del proyecto estará en el servidor remoto.For remote debugging, the project directory will be on the remote server.
Adjuntar (depurador Local de Windows y depurador remoto de Windows)Attach (Local Windows Debugger and Remote Windows Debugger) Especifica si se debe iniciar o asociar a la aplicación.Specifies whether to start or attach to the application. La configuración predeterminada es No.Default setting is No.
Nombre del servidor remoto (depurador remoto de Windows)Remote Server Name (Remote Windows Debugger) Especifica el nombre de un equipo (que no es el suyo) en el que desea depurar una aplicación.Specifies the name of a computer (other than yours) on which you want to debug an application.

La macro de compilación RemoteMachine está establecida en el valor de esta propiedad; Para obtener más información, consulte Macros para propiedades y comandos de generación.The RemoteMachine Build macro is set to the value of this property; for more information, see Macros for Build Commands and Properties.
Conexión (depurador remoto de Windows)Connection (Remote Windows Debugger) Permite intercambiar entre los tipos de conexión estándar y sin autenticación para la depuración remota.Allows you to switch between standard and no-authentication connection types for remote debugging. Especifique un nombre de equipo remoto en el nombre del servidor remoto cuadro.Specify a remote computer name in the Remote Server Name box. Entre los tipos de conexión se incluyen los siguientes:Connection types include the following:

- Remoto con autenticación de Windows- Remote with Windows Authentication
- Remoto sin autenticación- Remote with No Authentication

Tenga en cuenta la depuración sin autenticación puede dejar el equipo remoto expuesto a infracciones de seguridad.Note Remote debugging with No Authentication may leave the remote computer vulnerable to security violations. El modo de autenticación de Windows es más seguro.Windows Authentication mode is more secure.

Para obtener más información, consulte Remote Debugging Setup.For more information, see Remote Debugging Setup.
Dirección URL HTTP (depurador de servicio y depurador de explorador Web de Web)HTTP URL (Web Service Debugger and Web Browser Debugger) Especifica la dirección URL en la que se encuentra el proyecto que se depura.Specifies the URL where the project you are debugging is located.
Tipo de depuradorDebugger Type Especifica el tipo de depurador que se usará: solo nativo, solo administrado, solo GPU, Mixed, automática(valor predeterminado), o Script.Specifies the type of debugger to be used: Native Only, Managed Only, GPU Only, Mixed, Auto (default), or Script.

- Solo nativo es para código C++ no administrado.- Native Only is for unmanaged C++ code.
- Solo administrado es para código que se ejecuta bajo common language runtime (código administrado).- Managed Only is for code that runs under the common language runtime (managed code).
- Mixto invoca depuradores para ambos administrado y código no administrado.- Mixed invokes debuggers for both managed and unmanaged code.
- Auto determina el tipo de depurador basándose en la información del compilador y EXE.- Auto determines the debugger type based on compiler and EXE information.
- Secuencia de comandos invoca a un depurador de scripts.- Script invokes a debugger for scripts.
- Solo GPU es para código C++ AMP que se ejecuta en un dispositivo GPU o en el rasterizador de referencia de DirectX.- GPU Only is for C++ AMP code that runs on a GPU device or on the DirectX reference rasterizer. Vea depurar código de GPU.See Debugging GPU Code.
Entorno (depurador Local de Windows y depurador remoto de Windows)Environment (Local Windows Debugger and Remote Windows Debugger) Especifica las variables de entorno del programa que se depura.Specifies environment variables for the program that you are debugging. Use sintaxis de variable de entorno estándar (por ejemplo, PATH="%SystemRoot%\...").Use standard environment variable syntax (for example, PATH="%SystemRoot%\..."). Estas variables reemplazan el entorno de sistema o se combinan con el entorno del sistema, dependiendo de la Combinar entorno configuración.These variables override the system environment or are merged with the system environment, depending on the Merge Environment setting. Al hacer clic en la columna configuración, un "Editar..." aparece.When you click in the settings column, an "Edit..." appears. Haga clic en ese vínculo para modificar las variables de entorno.Click that link to edit environment variables.
Combinar entorno (depurador Local de Windows)Merge Environment (Local Windows Debugger) Determina si las variables que están especificados en el entorno cuadro se combinarán con el entorno definido por el sistema operativo.Determines whether the variables that are specified in the Environment box will be merged with the environment that is defined by the operating system. La configuración predeterminada es Sí.Default setting is Yes.
La depuración de SQL (todos menos el depurador de clúster MPI)SQL Debugging (all but MPI Cluster Debugger) Habilita la depuración de procedimientos SQL desde la aplicación de Visual C++Visual C++.Enables debugging of SQL procedures from your Visual C++Visual C++ application. La configuración predeterminada es No.Default setting is No.
Tipo de Acelerador de depuración (solo depuración de GPU)Debugging Accelerator Type (GPU debugging only) Especifica el dispositivo GPU que se debe usar para la depuración.Specifies the GPU device to use for debugging. La instalación de controladores de dispositivo para dispositivos GPU compatibles agregará opciones adicionales.Installing device drivers for compatible GPU devices will add additional options. La configuración predeterminada es "GPU - Emulador de software".The default setting is "GPU - Software Emulator."
Comportamiento de punto de interrupción de GPU predeterminado (solo depuración de GPU)GPU Default Breakpoint Behavior (GPU debugging only) Especifica si se debe generar un evento de punto de interrupción para cada subproceso de una deformación SIMD.Specifies whether a breakpoint event should be raised for each thread in a SIMD warp. La configuración predeterminada consiste en generar el evento de punto de interrupción una sola vez por deformación.The default setting is to raise the breakpoint event only once per warp.
Acelerador predeterminado de ampAmp Default Accelerator Especifica el acelerador predeterminado de AMP al depurar código de GPU.Specifies the default AMP accelerator when debugging GPU code. Elija Acelerador de software WARP para investigar si un problema está provocado por el hardware o un controlador en lugar del código.Choose WARP software accelerator to investigate if an issue is caused by the hardware or a driver instead of your code.
Directorio de implementación (depurador remoto de Windows)Deployment Directory (Remote Windows Debugger) Especifica la ruta de acceso en el equipo remoto en la que se copiará el resultado del proyecto antes del lanzamiento.Specifies the path on the remote computer where the project output will be copied prior to launch. La ruta de acceso puede ser un recurso compartido de red en el equipo remoto, o bien una ruta de acceso a una carpeta del equipo remoto.The path can be a network share on the remote computer, or it can be a path to a folder on the remote computer. La configuración predeterminada está vacía, lo que significa que el resultado del proyecto no se copia en un recurso compartido de red.The default setting is empty, which means the project output is not copied to a network share. Para habilitar la implementación de los archivos, también debe seleccionar la implementar casilla de verificación en el cuadro de diálogo Administrador de configuración.To enable deployment of the files, you must also select the Deploy check box in the Configuration Manager dialog box. Para obtener más información, consulte Cómo: Crear y editar configuraciones.For more information, see How to: Create and Edit Configurations.
Archivos adicionales para implementar (depurador remoto de Windows)Additional Files to Deploy (Remote Windows Debugger) Si se establece la propiedad Directorio de implementación, será una lista delimitada por punto y coma de archivos adicionales que se deben copiar en el directorio de implementación.If the Deployment Directory property is set, this is a semi-colon delimited list of additional files to copy to the deployment directory. La configuración predeterminada está vacía, lo que significa que no se copia ningún archivo adicional en el directorio de implementación.The default setting is empty, which means that no additional files are copied to the deployment directory. Para habilitar la implementación de los archivos, también debe seleccionar la implementar casilla de verificación en el cuadro de diálogo Administrador de configuración.To enable deployment of the files, you must also select the Deploy check box in the Configuration Manager dialog box. Para obtener más información, consulte Cómo: Crear y editar configuraciones.For more information, see How to: Create and Edit Configurations.
Implementar bibliotecas de depuración Visual C++ en tiempo de ejecución (depurador remoto de Windows)Deploy Visual C++ Debug Runtime Libraries (Remote Windows Debugger) Si se establece la propiedad Directorio de implementación, especifica si las bibliotecas de tiempo de ejecución de depuración de Visual C++ de la plataforma actual se deben copiar en el recurso compartido de red.If the Deployment Directory property is set, this specifies whether the Visual C++ debug runtime libraries for the current platform should be copied to the network share. El valor predeterminado es Sí.The default setting is Yes.

Carpeta C/C++ (categoría General)C/C++ folder (General category)

ParámetroSetting DescripciónDescription
Formato de la información de depuración (/Z7, / Zd, Zi, /ZI)Debug Information Format (/Z7, /Zd, Zi, /ZI) Especifica el tipo de información de depuración que se va a crear para el proyecto.Specifies the type of debug information to be created for the project.

La opción predeterminada (/ZI) crea una base de datos de programa (PDB) en formato compatible con Editar y continuar.The default option (/ZI) creates a program database (PDB) in Edit and Continue compatible format. Para obtener más información, consulte /Z7, / Zd, / Zi, /ZI (formato de información de depuración).For more information, see /Z7, /Zd, /Zi, /ZI (Debug Information Format).

Carpeta C/C++ (categoría Optimización)C/C++ folder (Optimization category)

ParámetroSetting DescripciónDescription
OptimizationOptimization Especifica si el compilador debe optimizar el código que produce.Specifies whether the compiler should optimize the code it produces. La optimización cambia el código que se ejecuta.Optimization changes the code that is executed. El código optimizado ya no coincide con el código fuente.Optimized code no longer matches the source code. Por tanto, la depuración resulta complicada.Therefore, debugging is difficult.

La opción predeterminada (deshabilitado (/ 0d) suprime la optimización.The default option (Disabled (/0d) suppresses optimization. Puede desarrollar con la optimización desactivada y activarla posteriormente cuando cree la versión de producción del código.You can develop with optimization suppressed, and then turn it on when you create the production version of your code.

Carpeta Vinculador (categoría Depuración)Linker folder (Debugging category)

ParámetroSetting DescripciónDescription
Generar información de depuración (/DEBUG)Generate Debug Info (/DEBUG) Indica al vinculador que incluya información de depuración, que tendrá el formato especificado mediante /Z7, /Zd, Zi o /ZI.Tells the linker to include debug information, which will have the format specified by /Z7, /Zd, Zi, or /ZI.
Generar archivo de base de datos de programa (/PDB:name)Generate Program Database File (/PDB:name) Especifique el nombre de un archivo PDB en este cuadro.Specify the name of a PDB file in this box. Debe seleccionar ZI o /Zi en Formato de la información de depuración.You must select ZI or /Zi for Debug Information Format.
Quitar símbolos privados (/PDBSTRIPPED:filename)Strip Private Symbols (/PDBSTRIPPED:filename) Especifique el nombre de un archivo PDB en este cuadro si no desea incluir símbolos privados en dicho archivo.Specify the name of a PDB file in this box if you do not want to include private symbols in the PDB file. Esta opción crea un segundo archivo de base de datos de programa (PDB) al generar la imagen de un programa con cualquiera de las opciones del compilador o el vinculador que generan archivos PDB, como /DEBUG, /Z7 o /Zd.This option creates a second program database (PDB) file when you build your program image with any of the compiler or linker options that generate a PDB file, such as /DEBUG, /Z7, /Zd. O /Zi.Or /Zi. En este segundo archivo PDB se omiten los símbolos que no se desea suministrar a los clientes.This second PDB file omits symbols that you would not want to ship to your customers. Para obtener más información, consulte /PDBSTRIPPED (quitar símbolos privados).For more information, see /PDBSTRIPPED (Strip Private Symbols).
Generar archivo de asignaciones (/MAP)Generate Map File (/MAP) Indica al vinculador que genere un archivo de asignaciones durante la vinculación.Tells the linker to generate a map file during linking. La configuración predeterminada es No.Default setting is No. Para obtener más información, consulte /MAP (generar archivo de asignaciones).For more information, see /MAP (Generate Mapfile).
Asignar el nombre de archivo (/MAP:nombre)Map File Name (/MAP:name) Si elige Generar archivo de asignaciones, puede especificar el archivo de asignaciones en este cuadro.If you choose Generate Map File, you can specify the map file in this box. Para obtener más información, consulte /MAP (generar archivo de asignaciones).For more information, see /MAP (Generate Mapfile).
Exportaciones de asignaciones (/MAPINFO:EXPORTS)Map Exports (/MAPINFO:EXPORTS) Incluye las funciones exportadas en el archivo de asignaciones.Includes exported functions in the map file. La configuración predeterminada es No.Default setting is No. Para obtener más información, consulte /MAPINFO (incluir información de archivo de asignaciones).For more information, see /MAPINFO (Include Information in Mapfile).
Ensamblado depurable (/ASSEMBLYDEBUG)Debuggable Assembly (/ASSEMBLYDEBUG) Especifica la configuración de la opción /ASSEMBLYDEBUG del vinculador.Specifies settings for the Linker /ASSEMBLYDEBUG option. Los valores posibles son los siguientes:Possible values are as follows:

- Sin el atributo debuggable.- No debuggable attribute emitted.
- En tiempo de ejecución seguimiento y deshabilitar optimizaciones (/ ASSEMBLYDEBUG).- Runtime tracking and disable optimizations (/ASSEMBLYDEBUG). Esta es la configuración predeterminada.This is the default setting,
- No hay optimizations(/ASSEMBLYDEBUG:DISABLE) en tiempo de ejecución de seguimiento y habilitar.- No runtime tracking and enable optimizations(/ASSEMBLYDEBUG:DISABLE).
- <heredar de primario o valores pred. >.- <inherit from parent or project defaults>.
-Para obtener más información, consulte /ASSEMBLYDEBUG (Agregar DebuggableAttribute).- For more information, see /ASSEMBLYDEBUG (Add DebuggableAttribute).

Puede cambiar esta configuración en la carpeta Propiedades de configuración (categoría Depuración) mediante programación a través de la interfaz de Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings.You can change these settings in the Configuration Properties folder (Debug category) programmatically by using the Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings interface. Para obtener más información, consulta VCDebugSettings.For more information, see VCDebugSettings.

Otras opciones de proyectoOther project settings

Para depurar los tipos de proyecto, como las bibliotecas estáticas y archivos DLL, el proyecto de Visual Studio debe ser capaz de encontrar los archivos correctos.To debug project types such as static libraries and DLLs, your Visual Studio project must be able to find the correct files. Si está disponible el código fuente, puede agregar bibliotecas estáticas y archivos DLL como proyectos independientes a la misma solución (Esto hace que la depuración).When source code is available, you can add static libraries and DLLs as separate projects to the same solution (this makes debugging easy). Para obtener información acerca de cómo crear estos tipos de proyecto, vea crear y utilizar una biblioteca de vínculos dinámicos (DLL) y crear una biblioteca estática mediante.For information on creating these project types, see Creating and using a Dynamic Link Library (DLL) and Creating a using a static library. Con el código fuente disponible, también puede crear un nuevo proyecto de Visual Studio eligiendo archivo > Nuevo > proyecto del código existente.With source code available, you can also create a new Visual Studio project by choosing File > New > Project From Existing Code.

Para depurar archivos DLL que son externas a su proyecto, consulte proyectos de archivos DLL de depuración.To debug DLLs that are external to your project, see Debugging DLL projects. Si tiene que depurar su propio proyecto DLL, pero no tiene acceso al proyecto de la aplicación que realiza la llamada, vea cómo depurar desde un proyecto DLL.If you need to debug your own DLL project, but don't have access to the project for the calling application, see How to debug from a DLL project.

Vea tambiénSee Also

Depuración de código nativo Debugging Native Code
Preparación y configuración de la depuración Debugger Settings and Preparation
Creación y administración de proyectos de Visual C++ Creating and Managing Visual C++ Projects
/ASSEMBLYDEBUG (Agregar DebuggableAttribute) /ASSEMBLYDEBUG (Add DebuggableAttribute)
Macros comunes para propiedades y comandos de compilaciónCommon Macros for Build Commands and Properties