Notificación de un problema con la documentación o el conjunto de herramientas de Microsoft C++
Si encuentra problemas con el compilador (MSVC), el vinculador o cualquier otra herramienta o biblioteca de Microsoft C++, háganoslo saber. Si el problema está en la documentación, también queremos estar al tanto.
Cómo informar de un problema del conjunto de herramientas de C++
La mejor manera de comunicarnos un problema consiste en enviarnos un informe que incluya una descripción del problema que haya detectado. Debe tener todos los detalles sobre cómo compilar el programa. Y debe incluir una reproducción, un caso de prueba completo que podamos usar para reproducir el problema en nuestras máquinas. Esta información nos permite comprobar rápidamente que el problema está en nuestro código y no es algo local de su entorno. Nos ayuda a determinar si afecta a otras versiones del compilador y a diagnosticar la causa.
En las siguientes secciones, verá qué es lo que hace que un informe sea bueno. Describimos cómo generar una reproducción del tipo de problema que ha detectado y cómo enviar el informe al equipo del producto. Sus informes son importantes para nosotros y para otros desarrolladores como usted. Gracias por ayudarnos a mejorar Microsoft C++.
Cómo preparar un informe
Es importante crear un informe de alta calidad, ya que nos resulta difícil reproducir el problema que encontró si no aporta información completa. Cuanto mejor sea su informe, más eficazmente podremos recrear y diagnosticar el problema.
Como mínimo, el informe debe contener lo siguiente:
Información de versión completa sobre el conjunto de herramientas que está usando.
La línea de comandos cl.exe completa usada para compilar el código.
Una descripción detallada del problema que se ha encontrado.
Una reproducción es un ejemplo de código fuente completo, simplificado y autocontenido en el que se muestra el problema en cuestión.
Siga leyendo para conocer qué información específica necesitamos, dónde puede encontrarla y cómo puede crear una reproducción correcta.
La versión del conjunto de herramientas
Necesitamos la información de versión completa y la arquitectura de destino del conjunto de herramientas que causa el problema. Así podremos probar la reproducción con el mismo conjunto de herramientas en nuestras máquinas. Si podemos reproducir el problema, esta información también nos dará un punto de partida para investigar en qué otras versiones del conjunto de herramientas se produce el mismo problema.
Para notificar la versión completa del compilador
Abra el símbolo del sistema para desarrolladores que coincida con la arquitectura de configuración y la versión de Visual Studio utilizadas para compilar su proyecto. Por ejemplo, si crea una compilación usando Visual Studio 2017 en x64 para destinos x64, elija el símbolo del sistema de las herramientas nativas x64 para VS 2017. Para obtener más información, vea Developer command prompt shortcuts (Accesos directos al símbolo del sistema para desarrolladores).
En la ventana de la consola del símbolo del sistema para desarrolladores, escriba el comando cl /Bv.
La salida debe tener un aspecto similar a:
C:\Users\username\Source>cl /Bv
Microsoft (R) C/C++ Optimizing Compiler Version 19.14.26428.1 for x86
Copyright (C) Microsoft Corporation. All rights reserved.
Compiler Passes:
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\cl.exe: Version 19.14.26428.1
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\c1.dll: Version 19.14.26428.1
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\c1xx.dll: Version 19.14.26428.1
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\c2.dll: Version 19.14.26428.1
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\link.exe: Version 14.14.26428.1
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\mspdb140.dll: Version 14.14.26428.1
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\1033\clui.dll: Version 19.14.26428.1
cl : Command line error D8003 : missing source filename
Copie y pegue toda la salida en el informe.
La línea de comandos
Necesitamos la línea de comandos exacta, cl.exe y todos sus argumentos que se usan para compilar el código. Solo así podremos compilarlo exactamente de la misma manera en nuestras máquinas. Esto es importante porque el problema que se ha encontrado podría existir únicamente al compilar con un argumento determinado o con una combinación de argumentos determinada.
El mejor lugar para encontrar esta información es el registro de compilación inmediatamente después de experimentar el problema. Esto garantiza que la línea de comandos contiene exactamente los mismos argumentos que podrían contribuir al problema.
Para informar sobre el contenido de la línea de comandos
Busque el archivo CL.command.1.tlog y ábralo. De forma predeterminada, este archivo se encuentra en la carpeta Documentos, en \Visual Studio versión\Projects\NombreDeLaSolución\NombreDelProyecto\Configuración\NombreDelProyecto.tlog\CL.command.1.tlog, o bien en la carpeta Usuario, en \Source\Repos\NombreDeLaSolución\NombreDelProyecto\Configuración\NombreDelProyecto.tlog\CL.command.1.tlog. Es posible que se encuentre en otra ubicación si utiliza otro sistema de compilación o ha modificado la ubicación predeterminada de su proyecto.
En este archivo, encontrará los nombres de los archivos de código fuente seguidos de los argumentos de la línea de comandos que se han usado para compilarlos, cada uno en líneas independientes.
Busque la línea que contiene el nombre del archivo de código fuente donde se produce el problema. La línea inferior contiene los argumentos de comando cl.exe correspondiente.
Copie y pegue toda la línea de comandos en el informe.
Una descripción del problema
Necesitamos una descripción detallada del problema que ha encontrado. Así podremos comprobar que vemos el mismo efecto en nuestras máquinas. También a veces nos resulta útil saber qué estaba intentando realizar y qué esperaba que ocurriera.
Una buena descripción incluye los mensajes de error exactos enviados por el conjunto de herramientas o el comportamiento en tiempo de ejecución exacto que observe. Necesitamos esta información para comprobar que hayamos reproducido el problema correctamente. Incluya toda la salida del compilador, no solo el último mensaje de error. Tenemos que ver todos los elementos que han provocado el problema del que nos informe. Si puede duplicar el problema con el compilador de la línea de comandos, se prefiere esa salida del compilador. El IDE y otros sistemas de compilación podrían filtrar los mensajes de error que ve, o capturar solo la primera línea de un mensaje de error.
Si el problema es que el compilador acepta código no válido y no genera ningún diagnóstico, inclúyalo en el informe.
Para informar de un problema de comportamiento en tiempo de ejecución, incluya una copia exacta de lo que el programa imprime y de lo que espera ver. Idealmente, insértelo en la propia instrucción de salida, por ejemplo, printf("This should be 5: %d\n", actual_result);. Si el programa se bloquea o deja de responder, menciónelo también.
Agregue cualquier otra información que nos pueda ayudar a diagnosticar el problema que ha encontrado, por ejemplo, una solución alternativa que haya detectado. Intente no repetir la información que se encuentra en otro lugar del informe.
La reproducción
Una reproducción es un ejemplo de código fuente completo y autocontenido. Demuestra de forma reproducible el problema encontrado, de ahí el nombre. Necesitamos una reproducción para poder reproducir el error en nuestros equipos. El código debería ser suficiente para crear un ejecutable simple que permita la compilación y la ejecución, o bien que las permitiera si no fuese por el problema que ha detectado. Una reproducción no es un fragmento de código. Debe tener funciones y clases completas y, además, contener todas las directivas #include necesarias, incluso en el caso de los encabezados estándares.
Características de una reproducción adecuada
A continuación encontrará lo que se considera una buena reproducción:
Es mínima. Las reproducciones deben ser lo más pequeñas posible, pero mostrar exactamente el problema encontrado. No es necesario que las reproducciones sean complejas o realistas. Basta con que muestren código que cumpla con el estándar o la implementación del compilador documentada. O bien, en el caso de que falte un diagnóstico, el código que no sea conforme. Las reproducciones simples y concisas que contienen solo el código suficiente para mostrar el problema son las mejores. Si puede eliminar o simplificar el código de forma que siga siendo conforme y dejar, a la vez, el problema sin cambios, también puede hacerlo. No es necesario incluir contraejemplos del código que funciona.
Es autocontenida. Las reproducciones deben evitar las dependencias innecesarias. Si puede reproducir el problema sin bibliotecas de terceros, hágalo. Si puede reproducir el problema sin código de biblioteca, además de proporcionar instrucciones de salida simples (por ejemplo,
puts("this shouldn't compile");,std::cout << value;yprintf("%d\n", value);), hágalo. La mejor opción es condensar un ejemplo en un único archivo de código fuente sin hacer referencia a ningún encabezado de usuario. Nos resulta extremadamente útil que reduzca la cantidad de código que debemos tener en cuenta como posible causante del problema.Tiene la versión más reciente del compilador. Las reproducciones deben usar la actualización más reciente de la última versión del conjunto de herramientas siempre que sea posible. También pueden usar la versión preliminar más reciente de la siguiente actualización o la próxima versión principal. A menudo, los problemas que se pueden encontrar en versiones anteriores del conjunto de herramientas se han corregido en las versiones más recientes. Las correcciones se trasladan a las versiones anteriores solo en circunstancias excepcionales.
Si procede, conviene realizar comprobaciones con otros compiladores. Las reproducciones que implican código C++ portátil deben comprobar su comportamiento con otros compiladores si es posible. El estándar de C++ determina en última instancia la corrección del programa, y ningún compilador es perfecto. Sin embargo, cuando Clang y GCC acepten su código sin diagnóstico y MSVC no lo haga, es probable que se trate de un error en el compilador. Existen otras posibilidades, como las diferencias entre el comportamiento de Unix y Windows o los distintos niveles de implementación de los estándares de C++, entre otras. Si todos los compiladores rechazan su código, es probable que este no sea correcto. Consultar distintos mensajes de error puede ayudarle a diagnosticar el problema.
Encontrará listas de compiladores en línea para probar su código en los compiladores en línea de C++ del sitio web del estándar ISO C++, o bien en esta lista de compiladores en línea de C++ de GitHub. Algunos ejemplos específicos son Wandbox y Compiler Explorer.
Nota
Los sitios web de compiladores en línea no están afiliados a Microsoft. Muchos sitios web de compiladores en línea se ejecutan como proyectos personales. Puede que algunos de ellos no estén disponibles cuando lea este artículo. Haga una búsqueda para encontrar otros que pueda usar.
Los problemas que se producen en compiladores, enlazadores o bibliotecas suelen mostrarse de una forma particular. El tipo de problema que ha encontrado determinará el tipo de reproducción que debe incluir en el informe. Sin una reproducción adecuada, no tenemos nada para investigar. Estos son algunos de los tipos de problemas que puede ver. Se incluyen instrucciones sobre cómo generar el tipo de reproducción que debe usar para informar de cada tipo de problema.
Bloqueo de front-end (analizador)
Los bloqueos de front-end se producen durante la fase de análisis del compilador. Normalmente, el compilador emite el mensaje Error irrecuperable C1001 y hace referencia al archivo de código fuente y al número de línea en que ocurrió el error. A menudo menciona el archivo msc1.cpp, pero puede pasar por alto este detalle.
Para este tipo de bloqueo, proporcione una reproducción preprocesada.
A continuación se muestra un ejemplo de la salida del compilador para este tipo de bloqueo:
SandBoxHost.cpp
d:\o\dev\search\foundation\common\tools\sandbox\managed\managed.h(929):
fatal error C1001: An internal error has occurred in the compiler.
(compiler file 'msc1.cpp', line 1369)
To work around this problem, try simplifying or changing the program near the
locations listed above.
Please choose the Technical Support command on the Visual C++
Help menu, or open the Technical Support help file for more information
d:\o\dev\search\foundation\common\tools\sandbox\managed\managed.h(929):
note: This diagnostic occurred in the compiler generated function
'void Microsoft::Ceres::Common::Tools::Sandbox::SandBoxedProcess::Dispose(bool)'
Internal Compiler Error in d:\o\dev\otools\bin\x64\cl.exe. You will be prompted
to send an error report to Microsoft later.
INTERNAL COMPILER ERROR in 'd:\o\dev\otools\bin\x64\cl.exe'
Please choose the Technical Support command on the Visual C++
Help menu, or open the Technical Support help file for more information
Bloqueo de back-end (generación de código)
Los bloqueos de back-end se producen durante la fase de generación de código del compilador. Normalmente, el compilador emite el mensaje Error irrecuperable C1001 y podría no hacer referencia al archivo de código fuente y al número de línea asociados con el problema. A menudo menciona el archivo compiler\utc\src\p2\main.c, pero puede omitir este detalle.
Para este tipo de bloqueo, proporcione una reproducción de vínculo si usa la Generación de código en tiempo de vínculo (LTCG), habilitada por el argumento de la línea de comandos /GL en cl.exe. De lo contrario, proporcione una reproducción preprocesada.
A continuación se muestra un ejemplo de salida del compilador para un bloqueo de back-end en el que no se usa LTCG. Si la salida del compilador tiene este aspecto, debe proporcionar una reproducción preprocesada.
repro.cpp
\\officefile\public\tadg\vc14\comperror\repro.cpp(13) : fatal error C1001:
An internal error has occurred in the compiler.
(compiler file 'f:\dd\vctools\compiler\utc\src\p2\main.c', line 230)
To work around this problem, try simplifying or changing the program near the
locations listed above.
Please choose the Technical Support command on the Visual C++
Help menu, or open the Technical Support help file for more information
INTERNAL COMPILER ERROR in
'C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\BIN\cl.exe'
Please choose the Technical Support command on the Visual C++
Help menu, or open the Technical Support help file for more information
Si la línea que empieza por ERROR INTERNO DEL COMPILADOR menciona link.exe en lugar de cl.exe, ya se ha habilitado LTCG. Proporcione una reproducción de vínculo en este caso. Cuando no esté claro si se ha habilitado LTCG desde el mensaje de error del compilador, examine los argumentos de la línea de comandos. Los copió del registro de compilación, en un paso anterior para el argumento de la línea de comandos /GL.
Bloqueo del enlazador
Los bloqueos del enlazador se producen durante la fase de vinculación, después de que se haya ejecutado el compilador. Normalmente, el enlazador emitirá el mensaje Linker Tools Error LNK1000 (Error de las herramientas del enlazador LNK1000).
Nota
Si la salida menciona C1001 o implica la Generación de código en tiempo de vínculo, vea Bloqueo de back-end (generación de código).
Para este tipo de bloqueo, proporcione una reproducción de vínculo.
A continuación se muestra un ejemplo de la salida del compilador para este tipo de bloqueo:
z:\foo.obj : error LNK1000: Internal error during IMAGE::Pass2
Version 14.00.22816.0
ExceptionCode = C0000005
ExceptionFlags = 00000000
ExceptionAddress = 00007FF73C9ED0E6 (00007FF73C9E0000)
"z:\tools\bin\x64\link.exe"
NumberParameters = 00000002
ExceptionInformation[ 0] = 0000000000000000
ExceptionInformation[ 1] = FFFFFFFFFFFFFFFF
CONTEXT:
Rax = 0000000000000400 R8 = 0000000000000000
Rbx = 000000655DF82580 R9 = 00007FF840D2E490
Rcx = 005C006B006F006F R10 = 000000655F97E690
Rdx = 000000655F97E270 R11 = 0000000000000400
Rsp = 000000655F97E248 R12 = 0000000000000000
Rbp = 000000655F97EFB0 E13 = 0000000000000000
Rsi = 000000655DF82580 R14 = 000000655F97F390
Rdi = 0000000000000000 R15 = 0000000000000000
Rip = 00007FF73C9ED0E6 EFlags = 0000000000010206
SegCs = 0000000000000033 SegDs = 000000000000002B
SegSs = 000000000000002B SegEs = 000000000000002B
SegFs = 0000000000000053 SegGs = 000000000000002B
Dr0 = 0000000000000000 Dr3 = 0000000000000000
Dr1 = 0000000000000000 Dr6 = 0000000000000000
Dr2 = 0000000000000000 Dr7 = 0000000000000000
Si la vinculación incremental está habilitada y el bloqueo se ha producido únicamente tras un vínculo inicial correcto (es decir, después de la primera vinculación completa en la que se basa la vinculación incremental posterior), proporcione también una copia de los archivos de objeto (.obj) y de biblioteca (.lib) que correspondan a los archivos de código fuente modificados tras completar el vínculo inicial.
Generación de código no válido
La generación de código no válido es poco frecuente. Se produce cuando el compilador genera por error código incorrecto que hace que la aplicación se bloquee en el tiempo de ejecución. En su lugar, debe generar código correcto o detectar un problema en el tiempo de compilación. Si cree que el problema encontrado provoca la generación de código no válido, considere el informe como si se tratara de un bloqueo de back-end (generación de código).
Para este tipo de bloqueo, proporcione una reproducción de vínculo si usa el argumento de la línea de comandos /GL en cl.exe. De lo contrario, proporcione una reproducción preprocesada.
Cómo generar una reproducción
Para que podamos rastrear el origen del problema, es muy importante que proporcione una reproducción adecuada. Antes de seguir los pasos que se indican a continuación para tipos de reproducción específicos, intente condensar al máximo el código que muestra el problema. Intente eliminar o minimizar las dependencias, los encabezados necesarios y las bibliotecas. Limite las opciones del compilador y las definiciones del preprocesador utilizadas, si es posible.
A continuación se muestran instrucciones para generar los distintos tipos de reproducciones que se usan para notificar los diversos problemas.
Reproducciones preprocesadas
Una reproducción preprocesada es un archivo de código fuente único que demuestra un problema. Se genera a partir de la salida del preprocesador de C. Para crear uno, use la opción del compilador /P en el archivo de código fuente de reproducción original. Esta opción inserta los encabezados incluidos para quitar las dependencias de archivos de encabezado y archivos de código fuente adicionales. También resuelve las macros, condicionales #ifdefs y otros comandos de preprocesador que podrían depender del entorno local.
Nota
Las reproducciones preprocesadas son menos útiles para los problemas que podrían ser consecuencia de errores de la implementación de biblioteca estándar, porque a menudo se sustituye la implementación más reciente en curso para ver si se ha corregido el problema. En este caso, no preprocese la reproducción y, si no puede reducir el problema a un solo archivo de código fuente, empaquete el código en un archivo .zip o similar, o bien considere la posibilidad de usar una reproducción de proyecto IDE. Para obtener más información, vea Otras reproducciones.
Para preprocesar un archivo de código fuente
Capture los argumentos de línea de comandos usados para generar su reproducción, tal como se indica en la sección Para informar sobre el contenido de la línea de comandos.
Abra el símbolo del sistema para desarrolladores que coincida con la arquitectura de configuración y la versión de Visual Studio utilizadas para compilar su proyecto.
Cámbielo al directorio que contenga el proyecto de reproducción.
En la ventana de la consola del símbolo del sistema para desarrolladores, escriba el comando cl /Pargumentsfilename.cpp. Para arguments, use la lista de argumentos capturados anteriormente. filename.cpp es el nombre del archivo de código fuente de reproducción. Este comando replica la línea de comandos usada para la reproducción, pero detiene la compilación después del paso del prerocesador. A continuación, genera la salida del código fuente preprocesado en filename.i.
Si preprocesa un archivo de código fuente de C++/CX o usa la característica de módulos de C++, se requieren algunos pasos adicionales. Para más información, vea la sección siguiente.
Cuando haya generado el archivo preprocesado, es recomendable que se asegure de que el problema se sigue reproduciendo al compilar el archivo preprocesado.
Para confirmar que el archivo preprocesado sigue reproduciendo el error
En la ventana de la consola del símbolo del sistema para desarrolladores, escriba el comando clarguments/TPfilename.i para indicar a cl.exe que compile el archivo preprocesado como un archivo de código fuente de C++. El valor arguments corresponde a los mismos argumentos capturados anteriormente, pero habiendo quitado los argumentos /D e /I. El motivo es que ya se han incluido en el archivo preprocesado. filename.i es el nombre del archivo preprocesado.
Confirme que el problema se reproduce.
Por último, adjunte a su informe la reproducción preprocesada filename.i.
Reproducciones de código de C++/CX preprocesadas para WinRT/UWP
Si usa C++/CX para compilar el archivo ejecutable, se requieren algunos pasos adicionales para crear y validar una reproducción preprocesada.
Para preprocesar el código fuente de C++/CX
Cree un archivo de código fuente preprocesado tal y como se describe en Para preprocesar un archivo de código fuente.
Busque el archivo nombre de archivo.i file generado para directivas de #using.
Cree una lista de todos los archivos a los que se hace referencia. No incluya los archivos Windows*.winmd los archivos platform.winmd y mscorlib.dll.
Para prepararse para validar que el archivo preprocesado todavía reproduce el problema.
Cree un directorio para el archivo preprocesado y copie el archivo en el nuevo directorio.
Copie los archivos .winmd de la lista #using en el nuevo directorio.
Cree un archivo vccorlib.h vacío en el nuevo directorio.
Modifique el archivo preprocesado para quitar las directivas #using de mscorlib.dll.
Modifique el archivo preprocesado para dejar las rutas de acceso absolutas en solo los nombres de archivo para los archivos .winmd copiados.
Confirme que el archivo preprocesado todavía reproduce el problema tal y como se indica anteriormente.
Reproducciones de módulos de C++ preprocesados
Si utiliza la característica de módulos del compilador de C++, se requieren algunos pasos distintos para crear y validar una reproducción preprocesada.
Para preprocesar un archivo de código fuente que usa un módulo
Capture los argumentos de línea de comandos usados para generar su reproducción, tal como se indica en la sección Para informar sobre el contenido de la línea de comandos.
Abra el símbolo del sistema para desarrolladores que coincida con la arquitectura de configuración y la versión de Visual Studio utilizadas para compilar su proyecto.
Cámbielo al directorio que contenga el proyecto de reproducción.
En la ventana de la consola del símbolo del sistema para desarrolladores, escriba el comando cl /Pargumentsfilename.cpp. El valor arguments corresponde a los argumentos capturados más arriba, y filename.cpp es el nombre del archivo de código fuente que consume el módulo.
Cambie al directorio que contiene el proyecto de reproducción que compila la interfaz del módulo (la salida de .ifc).
Capture los argumentos de línea de comandos que se utilizan para compilar la interfaz de módulo.
En la ventana de la consola del símbolo del sistema para desarrolladores, escriba el comando cl /Pargumentsmodulename.ixx. El valor arguments corresponde a los argumentos capturados más arriba, y modulename.ixx es el nombre del archivo que crea la interfaz del módulo.
Cuando haya generado el archivo preprocesado, es recomendable que se asegure de que el problema se sigue reproduciendo al utilizar el archivo preprocesado.
Para confirmar que el archivo preprocesado sigue reproduciendo el error
En la ventana de la consola del símbolo del sistema para desarrolladores, vuelva al directorio que contiene el proyecto de reproducción.
Escriba el comando clarguments/TPfilenamei., tal y como se indica anteriormente, para compilar el archivo preprocesado como si fuera un archivo de código fuente de C++.
Confirme que el archivo preprocesado todavía reproduce el problema.
Por último, adjunte los archivos de reproducción preprocesados (filenamei. y modulenamei.) con la salida de .ifc al informe.
Reproducciones de vínculo
Una reproducción de vínculo es el contenido generado por el enlazador de un directorio, especificado por la variable de entorno link_repro o bien como un argumento de la opción de enlazador /LINKREPRO. Contiene los artefactos de compilación que muestran conjuntamente un problema que se produce durante el tiempo de vínculo, como un bloqueo de back-end que implica la Generación de código en tiempo de vínculo (LTCG) o bien un bloqueo del vinculador. Estos artefactos de compilación son los que se necesitan como entrada del enlazador para que el problema pueda reproducirse. Una reproducción de vínculo se puede crear fácilmente mediante esta variable de entorno. Habilita la capacidad de generación de reproducciones integrada del vinculador.
Generar una reproducción de vínculo mediante la variable de entorno link_repro
Capture los argumentos de línea de comandos usados para generar su reproducción, tal como se indica en la sección Para informar sobre el contenido de la línea de comandos.
Abra el símbolo del sistema para desarrolladores que coincida con la arquitectura de configuración y la versión de Visual Studio utilizadas para compilar su proyecto.
En la ventana de la consola del símbolo del sistema para desarrolladores, cámbielo al directorio que contenga su proyecto de reproducción.
Escriba mkdir linkrepro para crear un directorio denominado linkrepro para la reproducción de vínculo. Puede usar otro nombre para capturar otra reproducción de vínculo.
Escriba el comando set link_repro=linkrepro para establecer la variable de entorno link_repro en el directorio que ha creado. Si la compilación se ejecuta desde otro directorio, como suele ser el caso de los proyectos más complejos, es mejor establecer link_repro en la ruta completa al directorio linkrepro.
Para generar el proyecto de reproducción en Visual Studio, escriba el comando devenv en la ventana de la consola del símbolo del sistema para desarrolladores. De este modo se garantiza que el valor de la variable de entorno link_repro sea visible para Visual Studio. Para compilar el proyecto en la línea de comandos, utilice los argumentos de línea de comandos capturados más arriba para duplicar la compilación de reproducción.
Compile el proyecto de reproducción y confirme que el problema esperado se haya producido.
Si ha usado Visual Studio para generar la compilación, ciérrelo.
En la ventana de la consola del símbolo del sistema para desarrolladores, escriba el comando set link_repro= para borrar la variable de entorno link_repro.
Por último, comprima todo el directorio de la reproducción de vínculo en un archivo .zip o similar para empaquetar la reproducción, y adjúntelo al informe.
La opción del enlazador /LINKREPRO tiene el mismo efecto que la variable de entorno link_repro. Puede usar la opción /LINKREPROTARGET para especificar el nombre por el que filtrar la reproducción de vínculo generada. Para usar /LINKREPROTARGET, también debe especificar la opción del enlazador /OUT.
Generar una reproducción de vínculo mediante la opción/LINKREPRO
Cree un directorio para almacenar la reproducción de vínculo. Nos referiremos a la ruta de acceso completa al directorio que cree como directory-path. Use comillas dobles alrededor de la ruta de acceso si incluye espacios.
Agregue el comando /LINKREPRO:directory-path a la línea de comandos del enlazador. En Visual Studio, abra el cuadro de diálogo Páginas de propiedades del proyecto. Seleccione la página de propiedades Propiedades de configuración>Enlazador>Línea de comandos. Después, escriba la opción /LINKREPRO:directory-path en el cuadro Opciones adicionales. Elija Aceptar para guardar los cambios.
Compile el proyecto de reproducción y confirme que el problema esperado se haya producido.
Por último, comprima todo el directorio de la reproducción de vínculo directory-path en un archivo .zip o similar para empaquetar la reproducción y adjúntelo al informe.
Otras reproducciones
Si no es posible reducir el problema a un solo archivo de código fuente o reproducción preprocesada y el problema no requiere una reproducción de vínculo, podemos investigar un proyecto IDE. Todas las instrucciones sobre cómo crear una buena reproducción siguen siendo aplicables: El código debería ser mínimo y autocontenido. El problema debe producirse en las herramientas más recientes y, si procede, no debería verse en otros compiladores.
Cree la reproducción como un proyecto IDE mínimo, comprima toda la estructura de directorios en un archivo .zip o similar para empaquetarlo y adjúntelo al informe.
Maneras de enviar el informe
Puede enviarnos el informe de dos maneras. Puede usar la herramienta de notificación de problemas integrada de Visual Studio o la página de Visual Studio Developer Community. También puede usar el botón Comentarios sobre el producto que está en la parte inferior de esta página. La elección depende de si quiere utilizar las herramientas integradas en el IDE para realizar capturas de pantalla y organizar el informe. Si no es así, puede usar directamente el sitio web de la comunidad de desarrolladores.
Nota
Independientemente de cómo envíe el informe, Microsoft respeta su privacidad. Microsoft se compromete a cumplir todas las leyes y los reglamentos sobre privacidad de datos. Para obtener información sobre cómo tratamos los datos que nos envía, vea la Declaración de privacidad de Microsoft.
Usar la herramienta Notificar un problema
La herramienta Notificar un problema de Visual Studio permite a los usuarios de Visual Studio informar sobre problemas en pocos clics. Aparece un formulario sencillo para enviar información detallada sobre el problema que ha detectado. A continuación, puede enviar el informe sin tener que salir del IDE.
Informar de un problema a través de la herramienta Notificar un problema del entorno de desarrollo integrado es fácil y útil. Para acceder a ella, elija el icono Enviar comentarios que encontrará junto al cuadro de búsqueda Inicio rápido. También la encontrará en la barra de menú, en Ayuda>Enviar comentarios>Notificar un problema.
Si elige informar de un error, primero intente encontrar problemas similares en la comunidad de desarrolladores. Si hay alguien que ya ha informado del problema en cuestión, vote a favor del informe y agregue sus comentarios con más detalles al respecto. Si no encuentra ningún problema similar, haga clic en Informar de un problema nuevo, en la parte inferior del cuadro de diálogo de Comentarios de Visual Studio, y siga los pasos para notificar el problema.
Uso de las páginas de la comunidad de desarrolladores de Visual Studio
Las páginas de la comunidad de desarrolladores de Visual Studio son otra forma muy útil de notificar problemas y encontrar soluciones para Visual Studio, el compilador de C++, las herramientas y las bibliotecas. Hay páginas específicas de Developer Community para Visual Studio, Visual Studio para Mac, .NET, C++, Azure DevOps y Azure DevOps Server.
Debajo de las pestañas de la comunidad, cerca de la parte superior de cada página, hay un cuadro de búsqueda. Puede usarlo para buscar publicaciones que informen de problemas similares al suyo. Es posible que ya esté disponible una solución u otra información útil relacionada con su problema. Si alguien ya ha notificado el mismo problema, vote a favor del informe y escriba su comentario en él, en lugar de crear otro informe sobre lo mismo. Para comentar, votar o notificar un problema nuevo, se pedirá que inicie sesión en su cuenta de Visual Studio. La primera vez que inicie sesión, tendrá que aceptar ofrecer acceso a su perfil a la aplicación de la comunidad de desarrolladores.
En caso de problemas con el compilador, el enlazador y otras herramientas y bibliotecas de C++, busque primero en la página C++ Developer Community. Si busca el problema y todavía nadie ha informado sobre él, haga clic en el botón Notificar un problema que encontrará junto al cuadro de búsqueda. Puede incluir el código y la línea de comandos para reproducir el problema, capturas de pantalla, vínculos a debates relacionados y cualquier otra información que crea útil y oportuna.
Sugerencia
Para otros tipos de problemas que puede encontrar en Visual Studio que no guardan relación con el conjunto de herramientas de C++ (por ejemplo, problemas de la interfaz de usuario, una funcionalidad del IDE interrumpida o bloqueos generales), use la herramienta Notificar un problema en el IDE. Esta es la mejor opción, debido a sus funcionalidades de captura de pantalla y su capacidad de grabar las acciones de la interfaz de usuario que conducen al problema que se ha encontrado. Estos tipos de errores también se pueden buscar en el sitio Visual Studio Developer Community. Para más información, vea Cómo notificar un problema con Visual Studio.
Informes y privacidad
Toda la información de los informes, así como los comentarios y las respuestas, están visibles públicamente. Normalmente, esto es una ventaja, porque permite que toda la comunidad vea los problemas, las soluciones y las soluciones alternativas que han encontrado otros usuarios. Aunque si le preocupa que por motivos de propiedad intelectual o privacidad se publiquen sus datos o su identidad, tiene otras opciones.
Si le preocupa que se revele su identidad, cree una cuenta Microsoft que no divulgue ningún detalle sobre usted. Utilice esta cuenta para crear el informe.
No incluya nada que no quiera revelar en el título ni el contenido del informe inicial, que es público. En cambio, señale que enviará detalles de forma privada en un comentario aparte. Para asegurarse de que el informe se dirige a las personas adecuadas, incluya cppcompiler en la lista de temas del informe de problemas. Ahora es posible especificar quién puede ver las respuestas y los datos adjuntos una vez creado el informe de problemas.
Para crear un informe de problemas con información privada
En el informe que ha creado, elija Agregar comentario para crear la descripción privada del problema.
En el editor respuestas, use el control de lista desplegable que aparece debajo de los botones Enviar y Cancelar para especificar los destinatarios de la respuesta. Solo las personas que especifique podrán ver estas respuestas privadas y las imágenes, los vínculos o el código que incluya en ellos. Elija Viewable by moderators and the original poster (Visible para los moderadores y el autor de la publicación original) para limitar la visibilidad a los empleados de Microsoft y a usted mismo.
Agregue la descripción y cualquier otra información, imágenes y datos adjuntos de archivo necesarios para la reproducción. Elija el botón Enviar para enviar esta información de forma privada.
Hay un límite de 2 GB en archivos adjuntos y un máximo de 10 archivos. Para una carga mayor, solicite una dirección URL de carga en el comentario privado.
Todas las respuestas incluidas en este comentario tienen la misma visibilidad restringida que haya especificado. Esto se cumple aunque el control de lista desplegable de respuestas no muestre el estado de visibilidad restringida correctamente.
Para preservar su privacidad y mantener la información confidencial fuera de la vista pública, tenga cuidado. Mantenga todas las interacciones con Microsoft sobre respuestas en este comentario restringido. Las respuestas a otros comentarios pueden provocar que accidentalmente se divulgue información confidencial.
Cómo informar de un problema con la documentación de C++
Los problemas de GitHub nos sirven para llevar un seguimiento de los problemas que se van detectando en la documentación. Ahora, puede crear problemas de GitHub directamente desde una página de contenido, lo que le permitirá interactuar de forma mucho más satisfactoria con los redactores y los equipos de producto. Si ve un problema en un documento, un ejemplo de código incorrecto, una explicación confusa, que falta algo fundamental o, simplemente, un error tipográfico, nos lo puede hacer saber con total facilidad. Vaya al final de la página y seleccione Sign in to give documentation feedback (Iniciar sesión para enviar comentario sobre la documentación). Tendrá que crear una cuenta de GitHub no aún no tiene una. Cuando tenga una cuenta de GitHub, podrá ver todos nuestros problemas de documentación y su estado. También recibirá notificaciones cuando se realicen cambios en relación con el problema que ha notificado. Para más información, consulte nuestra entrada de blog Sistema de comentarios.
Un problema de documentación en GitHub se crea con el botón de comentario sobre documentación. El problema se rellena automáticamente con información de la página sobre la que esté creando el problema. Así sabremos cómo localizarlo, así que no modifique esta información. Simplemente, incluya detalles sobre lo que no está bien y, si quiere, háganos una sugerencia sobre cómo corregirlo. Nuestros documentos de C++ son de código abierto, por lo que si desea enviar una corrección, puede hacerlo. Para más información sobre cómo puede contribuir en la documentación, vea nuestra guía de contribución en GitHub.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de