Come segnalare un problema con il set di strumenti o la documentazione di Microsoft C++

  • Articolo

Se si riscontrano problemi con il compilatore (MSVC), il linker o altri strumenti e librerie Microsoft C++, è necessario inviare una segnalazione a Microsoft. Anche se il problema riguarda la documentazione, è opportuno riportarlo.

Come segnalare un problema con il set di strumenti C++

Il modo migliore per segnalare un problema è inviare un report che include una descrizione del problema individuato. Il report dovrebbe includere tutti i dettagli del modo in cui è stato compilato il programma, oltre a includere una riproduzione del problema, ovvero un test case completo utilizzabile per riprodurre il problema nei computer Microsoft. Queste informazioni consentono a Microsoft di verificare rapidamente se il problema riguarda il codice e non è specifico dell'ambiente locale, nonché di determinare se influisce su altre versioni del compilatore e di diagnosticarne la causa.

Nelle sezioni seguenti vengono presentate le caratteristiche di un buon report. Viene descritto come generare una procedura di riproduzione per il tipo di problema individuato e come inviare il report al team di prodotto. I report sono strumenti importanti per tutti gli sviluppatori. Grazie per contribuire a migliorare Microsoft C++.

Come preparare il report

È importante creare un report di alta qualità, perché è difficile per Microsoft riprodurre il problema riscontrato senza informazioni complete. Più il report è completo, più alta è la probabilità che Microsoft possa ricreare il problema ed eseguire la diagnosi.

Il report deve contenere almeno le informazioni seguenti:

  • Informazioni complete sulla versione del set di strumenti usata.

  • L'intera riga di comando cl.exe usata per compilare il codice.

  • Una descrizione dettagliata del problema riscontrato.

  • Una procedura di riproduzione: un esempio di codice sorgente completo, semplificato e indipendente, che illustra il problema.

Continuare a leggere per sapere dove trovare le informazioni specifiche necessarie e come creare una procedura di riproduzione del problema esaustiva.

Versione del set di strumenti

Sono necessarie informazioni complete sulla versione e sull'architettura di destinazione del set di strumenti che causa il problema. In questo modo sarà possibile testare la procedura di riproduzione usando lo stesso set di strumenti nei computer Microsoft. Se il problema può essere riprodotto, queste informazioni rappresentano anche un punto di partenza per capire quali altre versioni del set di strumenti hanno lo stesso problema.

Per segnalare la versione completa del compilatore

  1. Aprire il prompt dei comandi per gli sviluppatori corrispondente alla versione di Visual Studio e all'architettura di configurazione usata per compilare il progetto. Ad esempio, se si usa Visual Studio 2017 in computer x64 per computer di destinazione x64, scegliere Prompt dei comandi degli strumenti nativi x64 per VS 2017. Per altre informazioni, vedere Collegamenti al prompt dei comandi per gli sviluppatori.

  2. Nella finestra della console del prompt dei comandi per gli sviluppatori immettere il comando cl /Bv.

L'output sarà simile al seguente:

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

Copiare e incollare l'intero output nel report.

Riga di comando

È necessaria la riga di comando esatta di cl.exe con tutti i relativi argomenti, usata per compilare il codice. In questo modo sarà possibile eseguire la compilazione nello stesso identico modo usato nei computer dei clienti. Questo passaggio è importante perché il problema riscontrato potrebbe verificarsi solo quando si compila un determinato argomento o una combinazione di argomenti.

Per trovare facilmente queste informazioni, vedere il log di compilazione immediatamente dopo che si è verificato il problema. La riga di comando conterrà esattamente gli stessi argomenti che potrebbero essere la causa del problema.

Per segnalare i contenuti della riga di comando

  1. Individuare il file CL.command.1.tlog e aprirlo. Per impostazione predefinita, questo file si trova nella cartella Documents in \Visual Studio version\Projects\SolutionName ProjectName Configuration ProjectName.tlog\\\\CL.command.1.tlog o nella cartella User in \Source\Repos\SolutionName\\ ProjectNameConfiguration\ProjectName.tlog\CL.command.1.tlog. Se si usa un altro sistema di compilazione o se è stato modificato il percorso predefinito per il progetto, il file può trovarsi in una posizione diversa.

    Il file contiene i nomi dei file del codice sorgente seguiti dagli argomenti della riga di comando usati per la compilazione, disposti su singole righe.

  2. Individuare la riga che contiene il nome del file del codice sorgente in cui si verifica il problema. La riga sottostante contiene gli argomenti del comando cl.exe corrispondenti.

Copiare e incollare l'intera riga di comando nel report.

Descrizione del problema

È necessaria una descrizione dettagliata del problema riscontrato. Questo è il modo in cui è possibile verificare di ottenere lo stesso effetto nei computer Microsoft. La descrizione è a volte anche utile per capire cosa stava tentando di eseguire l'utente e quali risultati si aspettava.

Una buona descrizione include i messaggi di errore esatti generati dal set di strumenti o l'esatto comportamento del runtime. Queste informazioni sono necessarie per verificare che il problema sia stato riprodotto correttamente. Includere tutto l'output del compilatore e non solo l'ultimo messaggio di errore. È necessario avere a disposizione tutti gli elementi che hanno causato il problema segnalato. Se è possibile duplicare il problema usando il compilatore della riga di comando, è preferibile l'output del compilatore. L'IDE e altri sistemi di compilazione potrebbero filtrare i messaggi di errore visualizzati o acquisire solo la prima riga di un messaggio di errore.

Se il problema consiste nel fatto che il compilatore accetta codice non valido e non genera dati di diagnostica, includerlo nel report.

Per segnalare un problema di comportamento del runtime, includere una copia esatta della stampa del programma e di ciò che dovrebbe essere visualizzato. L'ideale sarebbe incorporarla nell'istruzione di output stessa, ad esempio, printf("This should be 5: %d\n", actual_result);. Segnalare anche se il programma si arresta in modo anomalo o si blocca.

Aggiungere qualsiasi altro dettaglio che potrebbe contribuire a diagnosticare il problema riscontrato, ad esempio eventuali soluzioni alternative individuate. Cercare di non ripetere le informazioni già presenti altrove nel report.

Procedura di riproduzione

Una procedura di riproduzione è un esempio di codice sorgente completo e indipendente, che consente di dimostrare in modo riproducibile il problema. La procedura di riproduzione è necessaria perché sia possibile riprodurre l'errore nei computer Microsoft. Il codice dovrebbe essere sufficiente da solo per creare un file eseguibile di base che viene compilato ed eseguito. O meglio, che verrebbe compilato ed eseguito se non per il problema riscontrato. Una procedura di riproduzione non è un frammento di codice. Deve contenere funzioni e classi complete e tutte le direttive #include necessarie, anche per le intestazioni standard.

Procedura di riproduzione esaustiva

Una procedura di riproduzione esaustiva è:

  • Minimo. È necessario che le procedure di riproduzione siano minime, ma devono comunque illustrare esattamente il problema riscontrato. Le procedure di riproduzione non devono essere né complesse né realistiche. È sufficiente che dimostrino codice conforme allo standard o all'implementazione del compilatore documentata. Per una diagnostica mancante, la procedura di riproduzione dovrebbe visualizzare il codice non conforme. Sono preferibili procedure di riproduzione semplici e pertinenti, che contengono solo il codice sufficiente a illustrare il problema. Se possibile, eliminare o semplificare il codice rimanendo conformi e lasciando inalterato il problema. Non è necessario includere controesempi di codice funzionante.

  • Indipendente. È consigliabile non includere nelle procedure di riproduzione dipendenze non necessarie. Se possibile, riprodurre il problema senza usare librerie di terzi. Se possibile, riprodurre il problema senza usare codice di libreria oltre alle semplici istruzioni di output, ad esempio puts("this shouldn't compile");, std::cout << value; e printf("%d\n", value);. È preferibile ridurre l'esempio a un singolo file di codice sorgente senza riferimento a intestazioni utente. È molto utile ridurre la quantità di codice da analizzare come possibile responsabile del problema.

  • Confronto con l'ultima versione del compiler Le procedure di riproduzione devono usare l'aggiornamento più recente dell'ultima versione del set di strumenti quando possibile. In alternativa, usare la versione provvisoria più recente dell'aggiornamento successivo o della versione principale successiva. Spesso è possibile che i problemi che si verificano ancora nelle versioni precedenti del set di strumenti siano stati risolti nelle versioni più recenti. Il backporting delle correzioni in versioni precedenti avviene solo in casi eccezionali.

  • Confronto con altri compilatori, se pertinente. Le procedure di riproduzione che contengono codice C++ portabile devono verificare il comportamento confrontandolo con altri compilatori se possibile. Lo standard C++ stabilisce in definitiva la correttezza del programma e nessun compilatore è perfetto. Tuttavia, quando Clang e GCC accettano il codice senza una diagnostica e MSVC non lo accetta, probabilmente ciò indica un bug nel compilatore Microsoft. Altre possibilità includono differenze tra il comportamento unix e Windows o diversi livelli di implementazione degli standard C++ e così via. Quando tutti i compilatori rifiutano il codice, è probabile che il codice non sia corretto. Analizzare messaggi di errore diversi può aiutare l'utente a diagnosticare il problema.

    In Online C++ compilers (Compilatori C++ online) oppure in questo elenco dettagliato List of Online C++ Compilers (Elenco di compilatori C++ online) in GitHub sono disponibili elenchi di compilatori online per testare e confrontare il codice. Alcuni esempi specifici includono Wandbox e Compiler Explorer.

    Nota

    I siti Web dei compilatori online non sono associati a Microsoft. Molti siti Web dei compilatori online vengono eseguiti come progetti personali. Alcuni di questi siti potrebbero non essere disponibili quando si legge questo articolo, ma con una ricerca dovrebbe essere semplice trovarne altri.

I problemi che riguardano compilatore, linker e librerie sono soliti manifestarsi in modi particolari. In base al tipo di problema riscontrato, è necessario scegliere il tipo di procedura di riproduzione da includere nel report. Senza una corretta procedura di riproduzione, è impossibile eseguire un'analisi. Ecco alcuni dei tipi di problemi che si potrebbero riscontrare. Sono incluse istruzioni su come generare il tipo di procedura di riproduzione che è consigliabile usare per segnalare ogni tipo di problema.

Arresto anomalo del front-end (parser)

Gli arresti anomali del front-end si verificano durante la fase di analisi del compilatore. In genere, il compilatore genera l'errore irreversibile C1001 con riferimenti al file del codice sorgente e al numero di riga in cui si è verificato l'errore. Spesso viene menzionato un file denominato msc1.cpp, ma è possibile ignorare questo dettaglio.

Per questo tipo di arresto anomalo, inviare una procedura di riproduzione pre-elaborata.

Di seguito è riportato un esempio di output del compilatore per questo tipo di arresto anomalo:

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

Arresto anomalo del back-end (generazione del codice)

Gli arresti anomali del back-end si verificano durante la fase di generazione del codice del compilatore. In genere, il compilatore genera l'errore irreversibile C1001 e potrebbe non includere riferimenti al file del codice sorgente e al numero di riga associati al problema. Spesso viene menzionato il compilatore di file\utc\src\p2\main.c, ma è possibile ignorare questo dettaglio.

Per questo tipo di arresto anomalo, inviare una procedura di riproduzione del collegamento se si usa la Generazione codice in fase di collegamento, abilitata dall'argomento della riga di comando /GL in cl.exe. Altrimenti, inviare una procedura di riproduzione pre-elaborata.

Di seguito è riportato un esempio di output del compilatore per un arresto anomalo del back-end in cui la Generazione codice in fase di collegamento non è in uso. Se l'output del compilatore è simile al seguente, è necessario inviare una procedura di riproduzione pre-elaborata.

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

Se la riga che inizia con INTERNAL COMPILER ERROR specifica link.exe anziché cl.exe, significa che la Generazione codice in fase di collegamento è stata abilitata. Inviare una procedura di riproduzione del collegamento in questo caso. Quando non è chiaro se la Generazione codice in fase di collegamento è stata abilitata dal messaggio di errore del compilatore, esaminare gli argomenti della riga di comando. Sono stati copiati dal log di compilazione, in un passaggio precedente per l'argomento della riga di comando /GL.

Arresto anomalo del linker

Gli arresti anomali del linker si verificano durante la fase di collegamento, dopo l'esecuzione del compilatore. In genere il linker crea l'errore strumenti del linker LNK1000.

Nota

Se invece l'output specifica C1001 o include la Generazione codice in fase di collegamento, fare riferimento ad Arresto anomalo del back-end (generazione del codice).

Per questo tipo di arresto anomalo, inviare una procedura di riproduzione del collegamento.

Di seguito è riportato un esempio di output del compilatore per questo tipo di arresto anomalo:

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

Se è abilitato il collegamento incrementale e l'arresto anomalo si è verificato solo dopo il collegamento iniziale, vale a dire solo dopo il primo collegamento completo su cui si basa il collegamento incrementale successivo, inviare anche una copia dei file oggetto (con estensione obj) e libreria (con estensione lib) che corrispondono ai file sorgente che sono stati modificati dopo il completamento del collegamento iniziale.

Generazione di codice errato

La generazione di codice errato è rara. Si verifica quando il compilatore genera erroneamente codice non corretto che causa l'arresto anomalo in fase di esecuzione dell'applicazione. Dovrebbe invece generare codice corretto o rilevare un problema in fase di compilazione. Se si ritiene che il problema riscontrato determini la generazione di codice errato, organizzare il report come nel caso di Arresto anomalo del back-end (generazione del codice).

Per questo tipo di arresto anomalo, inviare una procedura di riproduzione del collegamento se si usa l'argomento della riga di comando /GL in cl.exe. Altrimenti, inviare una procedura di riproduzione pre-elaborata.

Come generare una procedura di riproduzione

Per poter risalire alla causa del problema, è essenziale una procedura di riproduzione esaustiva. Prima di eseguire i passaggi descritti di seguito per tipi specifici di riproduzione, ridurre il più possibile il codice che illustra il problema. Provare a eliminare o ridurre al minimo le dipendenze, le intestazioni richieste e le librerie. Limitare le opzioni del compilatore e le definizioni del preprocessore usate, se possibile.

Di seguito sono disponibili le istruzioni per la generazione dei vari tipi di procedure di riproduzione che verranno usate per segnalare i diversi problemi.

Procedure di riproduzione pre-elaborate

Una procedura di riproduzione pre-elaborata è un singolo file di origine che dimostra un problema. Viene generata dall'output del preprocessore C. Per crearne una, usare l'opzione del compilatore /P nel file di origine della procedura di riproduzione originale. Questa opzione inserisce inline le intestazioni incluse per rimuovere le dipendenze da altri file di origine e di intestazione. L'opzione risolve anche le macro, le istruzioni condizionali #ifdef e altri comandi del preprocessore che potrebbero dipendere dall'ambiente locale.

Nota

Le procedure di riproduzione pre-elaborate non sono adatte a segnalare problemi causati probabilmente da bug presenti nell'implementazione della libreria standard. Capita spesso infatti che Microsoft decida di sostituire l'ultima implementazione non definitiva per verificare se il problema è già stato risolto. In questo caso non pre-elaborare la procedure di riproduzione. Se non è possibile ridurre il problema a un solo file di origine, comprimere il codice in un file ZIP, o simile, oppure usare una procedura di riproduzione del progetto IDE. Per altre informazioni, vedere Altre procedure di riproduzione.

Per pre-elaborare un file del codice sorgente

  1. Acquisire gli argomenti della riga di comando usati per compilare la procedura di riproduzione, come descritto in Per segnalare i contenuti della riga di comando.

  2. Aprire il prompt dei comandi per gli sviluppatori corrispondente alla versione di Visual Studio e all'architettura di configurazione usata per compilare il progetto.

  3. Passare alla directory che contiene il progetto della procedura di riproduzione.

  4. Nella finestra della console del prompt dei comandi per gli sviluppatori immettere il comando cl /Pargomentinomefile.cpp. Per argomenti usare l'elenco degli argomenti acquisiti in precedenza. nomefile.cpp è il nome del file di origine della procedura di riproduzione. Questo comando consente di replicare la riga di comando usata per la riproduzione, ma arresta la compilazione dopo il passaggio del preprocessore, quindi scrive il codice sorgente pre-elaborato in nomefile.i.

Se è in pre-elaborazione un file del codice sorgente C++/CX o è in uso la funzionalità Moduli C++, sono necessari alcuni passaggi aggiuntivi. Per altre informazioni, vedere le sezioni riportate di seguito.

Dopo aver generato il file pre-elaborato, è consigliabile verificare che il problema sia ancora riproducibile quando si compila il file pre-elaborato.

Per verificare che il file pre-elaborato consenta ancora di riprodurre l'errore

  1. Nella finestra della console del prompt dei comandi per gli sviluppatori, immettere il comando clargomenti/TPnomefile.i per indicare a cl.exe di compilare il file pre-elaborato come un file di origine C++. Gli argomenti sono gli stessi argomenti acquisiti in precedenza, ma con eventuali argomenti /D e /I rimossi, perché sono già stati inclusi nel file pre-elaborato. nomefile.i è il nome del file pre-elaborato.

  2. Verificare che il problema viene riprodotto.

Infine, allegare la procedura di riproduzione pre-elaborata nomefile.i al report.

Procedure di riproduzione del codice C++/CX WinRT/UWP pre-elaborato

Se si usa C++/CX per compilare l'eseguibile, sono necessari alcuni passaggi aggiuntivi per creare e convalidare una procedura di riproduzione pre-elaborata.

Per pre-elaborare un file del codice sorgente C++/CX

  1. Creare un file del codice sorgente pre-elaborato come descritto in Per pre-elaborare un file del codice sorgente.

  2. Cercare il file nomefile.i generato per le direttive #using.

  3. Creare un elenco di tutti i file di riferimento. Lasciare i file Windows*.winmd, i file platform.winmd e mscorlib.dll.

Per prepararsi a convalidare la riproduzione del problema usando il file pre-elaborato

  1. Creare una nuova directory per il file pre-elaborato e copiarlo nella nuova directory.

  2. Copiare i file con estensione winmd dall'elenco #using nella nuova directory.

  3. Creare un file vccorlib.h vuoto nella nuova directory.

  4. Modificare il file pre-elaborato per rimuovere qualsiasi direttiva #using per mscorlib.dll.

  5. Modificare il file pre-elaborato per modificare eventuali percorsi assoluti ai nomi di file bare per i file con estensione winmd copiati.

Confermare che il problema di cui sopra sia ancora riproducibile dal file pre-elaborato.

Procedure di riproduzione dei moduli C++ pre-elaborati

Se si usa la funzionalità di moduli del compilatore C++, sono necessari alcuni passaggi diversi per creare e convalidare una procedura di riproduzione pre-elaborata.

Per pre-elaborare un file del codice sorgente che usa un modulo

  1. Acquisire gli argomenti della riga di comando usati per compilare la procedura di riproduzione, come descritto in Per segnalare i contenuti della riga di comando.

  2. Aprire il prompt dei comandi per gli sviluppatori corrispondente alla versione di Visual Studio e all'architettura di configurazione usata per compilare il progetto.

  3. Passare alla directory che contiene il progetto della procedura di riproduzione.

  4. Nella finestra della console del prompt dei comandi per gli sviluppatori immettere il comando cl /Pargomentinomefile.cpp. Gli argomenti sono gli argomenti acquisiti in precedenza e nomefile.cpp è il nome del file di origine che utilizza questo modulo.

  5. Passare alla directory contenente il progetto di riproduzione con cui è stata compilata l'interfaccia del modulo (output con estensione ifc).

  6. Acquisire gli argomenti della riga di comando usati per compilare l'interfaccia del modulo.

  7. Nella finestra della console del prompt dei comandi per gli sviluppatori immettere il comando cl /Pargomentinomemodulo.ixx. Gli argomenti sono gli argomenti acquisiti in precedenza e nomemodulo.ixx è il nome del file che crea l'interfaccia del modulo.

Dopo aver generato i file pre-elaborati, è consigliabile verificare che il problema sia ancora riproducibile usando il file pre-elaborato.

Per verificare che il file pre-elaborato consenta ancora di riprodurre l'errore

  1. Nella finestra della console per gli sviluppatori passare alla directory che contiene il progetto della procedura di riproduzione.

  2. Immettere il comando clargomenti/TPnomefile.i come descritto in precedenza, per compilare il file pre-elaborato come se fosse un file di origine C++.

  3. Confermare che il problema sia ancora riproducibile dal file pre-elaborato.

Infine, allegare alla segnalazione i file pre-elaborati per la procedura di riproduzione (nomefile.i e nomemodulo.i) e l'output con estensione ifc.

Un repro di collegamento è il contenuto generato dal linker di una directory, specificato dalla variabile di ambiente link_repro o come argomento all'opzione di collegamento /LINKREPRO . Contiene gli artefatti della compilazione che insieme dimostrano un problema che si verifica in fase di collegamento. Ad esempio un arresto anomalo del back-end che interessa la Generazione codice in fase di collegamento (LTCG) o un arresto anomalo del linker. Questi artefatti di compilazione sono quelli necessari come input del linker in modo che il problema possa essere riprodotto. È possibile creare facilmente un collegamento usando questa variabile di ambiente. Abilita la funzionalità di generazione della procedura di riproduzione predefinita del linker.

  1. Acquisire gli argomenti della riga di comando usati per compilare la procedura di riproduzione, come descritto in Per segnalare i contenuti della riga di comando.

  2. Aprire il prompt dei comandi per gli sviluppatori corrispondente alla versione di Visual Studio e all'architettura di configurazione usata per compilare il progetto.

  3. Nella finestra della console del prompt dei comandi per gli sviluppatori passare alla directory che contiene il progetto della procedura di riproduzione.

  4. Immettere mkdir linkrepro per creare una directory denominata linkrepro per il collegamento di nuovo. È possibile usare un nome diverso per acquisire un altro collegamento riprova.

  5. Immettere il set di comandi link_repro=linkrepro per impostare la variabile di ambiente link_repro sulla directory creata. Se la compilazione viene eseguita da una directory diversa, come spesso accade per progetti più complessi, impostare link_repro sul percorso completo della directory di ripetizione del collegamento.

  6. Per compilare il progetto della procedura di riproduzione in Visual Studio, immettere il comando devenv nella finestra della console del prompt dei comandi per gli sviluppatori. Garantisce che il valore della variabile di ambiente link_repro sia visibile a Visual Studio. Per compilare il progetto nella riga di comando, usare gli argomenti della riga di comando acquisiti in precedenza per duplicare la compilazione della procedura di riproduzione.

  7. Compilare il progetto della procedura di riproduzione e confermare che il problema previsto si è verificato.

  8. Chiudere Visual Studio se è stato usato per eseguire la compilazione.

  9. Nella finestra della console del prompt dei comandi per sviluppatori immettere il set di comandi link_repro= per cancellare la variabile di ambiente link_repro .

Infine, comprimere l'intera directory linkrepro in un file .zip o simile e collegarla al report.

L'opzione /LINKREPRO linker ha lo stesso effetto della variabile di ambiente link_repro . È possibile usare l'opzione /LINKREPROTARGET per specificare il nome da filtrare per il repro del collegamento generato. Per usare /LINKREPROTARGET, è necessario specificare anche l'opzione /OUT linker.

  1. Creare una directory per contenere il repro del collegamento. Verrà fatto riferimento al percorso della directory completo creato come percorso directory. Usare virgolette doppie intorno al percorso se include spazi.

  2. Aggiungere il comando /LINKREPRO:directory-path alla riga di comando del linker. In Visual Studio aprire la finestra di dialogo Pagine proprietà per il progetto. Selezionare la pagina delle proprietà della riga dicomando Proprietà > dellinker>di configurazione. Immettere quindi l'opzione /LINKREPRO:directory-path nella casella Opzioni aggiuntive . Scegliere OK per salvare le modifiche.

  3. Compilare il progetto della procedura di riproduzione e confermare che il problema previsto si è verificato.

Infine, creare un pacchetto del repro comprimere l'intera directory del collegamento del percorso directory in un file .zip o simile e collegarlo al report.

Altre procedure di riproduzione

Se non è possibile ridurre il problema a un singolo file di origine o riprovare pre-elaborati e il problema non richiede un nuovo collegamento, è possibile analizzare un progetto IDE. Tutte le indicazioni su come creare un buon repro si applicano ancora: il codice deve essere minimo e autonomo. Il problema dovrebbe verificarsi negli strumenti Microsoft più recenti e se rilevante, non dovrebbe comparire in altri compilatori.

Creare la procedura di riproduzione come progetto IDE minimo, comprimere l'intera struttura della directory in un file con estensione zip o simile e allegarla al report.

Modi per inviare il report

Esistono un paio di modi utili per inviare il report a Microsoft. È possibile usare lo strumento di creazione di report dei problemi predefiniti di Visual Studio o la pagina di Developer Community di Visual Studio. È anche disponibile il pulsante Commenti sul prodotto nella parte inferiore della pagina. La scelta dipende dal fatto che si desideri o meno usare gli strumenti predefiniti nell'IDE per acquisire gli screenshot e organizzare il report. Se si preferisce non usarli, è possibile usare direttamente il sito Web della community degli sviluppatori.

Nota

Indipendentemente dalla modalità di invio del report, Microsoft rispetta la privacy degli utenti. Microsoft garantisce conformità a tutte le leggi che regolano la privacy dei dati. Per informazioni sul trattamento dei dati inviati a Microsoft, vedere l'Informativa sulla privacy di Microsoft.

Usare lo strumento Segnala un problema

Segnala un problema è uno strumento di Visual Studio che consente agli utenti di segnalare i problemi con pochi clic. Viene visualizzato un modulo semplice per inviare informazioni dettagliate sul problema riscontrato. È quindi possibile inviare il report senza mai uscire dall'IDE.

Segnalare il problema tramite lo strumento Segnala un problema dall'IDE è facile e comodo. È possibile accedervi dalla barra del titolo scegliendo l'icona Invia commenti e suggerimenti accanto alla casella di ricerca Avvio veloce. In alternativa, è possibile trovarlo sulla barra dei menu in Guida>Invia report commenti e suggerimenti>a un problema.

Quando si sceglie di segnalare un problema, eseguire la ricerca di problemi simili nella Community degli sviluppatori. Nel caso il problema sia stato segnalato in precedenza, votare a favore della segnalazione e aggiungere un commento con informazioni specifiche. Se non viene visualizzato un problema analogo, fare clic sul pulsante Segnala un nuovo problema nella parte inferiore della finestra di dialogo Commenti e suggerimenti di Visual Studio e seguire i passaggi per segnalare il problema.

Usare le pagine della community di sviluppatori di Visual Studio

Le pagine della community di sviluppatori di Visual Studio sono un altro modo pratico per segnalare problemi e trovare soluzioni per Visual Studio e il compilatore C++, strumenti e librerie. Sono disponibili pagine di Developer Community specifiche per Visual Studio, Visual Studio per Mac, .NET, C++, Azure DevOps e Azure DevOps Server.

Sotto le schede della community, nella parte superiore di ogni pagina, è presente una casella di ricerca. È possibile usarla per trovare i post che segnalano problemi simili ai propri. Possono già essere presenti soluzioni o altre informazioni utili relative al problema. Se un utente ha riportato lo stesso problema in precedenza, votare a favore della segnalazione e aggiungere un commento anziché procedere con una nuova segnalazione del problema. Per commentare, votare o segnalare un problema nuovo, potrebbe essere chiesto di accedere all'account di Visual Studio. Al primo accesso si dovrà accettare di concedere l'accesso al profilo personale all'app della community degli sviluppatori.

Per problemi relativi al compilatore C++, al linker e ad altre librerie e strumenti, cercare prima la pagina di Developer Community C++. Se un problema non è stato segnalato in precedenza, fare clic sul pulsante Segnala un problema accanto alla casella di ricerca. È possibile includere il codice della procedura di riproduzione e la riga di comando, screenshot, collegamenti alle discussioni correlate e qualsiasi altra informazione attinente e utile.

Suggerimento

Per altri tipi di problemi riscontrabili in Visual Studio non correlati al set di strumenti C++ (ad esempio, problemi dell'interfaccia utente, funzionalità dell'IDE interrotte o arresti anomali generali), usare lo strumento Segnala un problema nell'IDE. Si tratta della scelta migliore, considerate le funzionalità di screenshot e la possibilità di registrare le azioni dell'interfaccia utente che hanno portato al problema riscontrato. Questi tipi di errori possono essere cercati anche nel sito di Developer Community di Visual Studio. Per altre informazioni, vedere Come segnalare un problema con Visual Studio.

Segnalazioni e privacy

Tutte le informazioni contenute nelle segnalazioni, i commenti e le risposte sono pubblicamente visibili per impostazione predefinita. In genere si tratta di un vantaggio, perché consente all'intera community di visualizzare i problemi, le soluzioni e le soluzioni alternative individuate da altri utenti. Tuttavia, se per motivi di privacy o di proprietà intellettuale, si teme che i propri dati o la propria identità diventino di dominio pubblico, sono disponibili alcune opzioni.

Se non si vuole rivelare la propria identità, creare un nuovo account Microsoft che non divulghi informazioni personali. Usare questo account per creare la segnalazione.

Nel titolo o nel contenuto della segnalazione iniziale che sono pubblici, non inserire informazioni che si vogliono mantenere private. Indicare invece che i dettagli saranno inviati privatamente in un commento a parte. Per assicurarsi che la segnalazione sia indirizzata al destinatario corretto, includere cppcompiler nell'elenco degli argomenti nella segnalazione del problema. Dopo aver segnalato il problema, è possibile specificare chi potrà visualizzare le risposte e gli allegati.

Per creare una segnalazione di un problema con informazioni private

  1. Nella segnalazione creata scegliere Aggiungi commento per creare la descrizione privata del problema.

  2. Nell'editor di risposta usare l'elenco a discesa per il controllo sotto i pulsanti Invia e Annulla per specificare chi potrà visualizzare la risposta. Solo le persone specificate potranno visualizzare le risposte private, le immagini, i collegamenti o il codice inclusi nelle risposte. Scegliere Viewable by moderators and the original poster (Visualizzabile da moderatori e dall'autore originale del post) per limitare la visibilità ai dipendenti Microsoft e all'utente.

  3. Aggiungere la descrizione ed eventuali altre informazioni, immagini e allegati di file necessari per la procedura di riproduzione. Scegliere il pulsante Invia per inviare queste informazioni privatamente.

    Esiste un limite di 2 GB per i file allegati e un massimo di 10 file. Per caricare file di dimensioni maggiori, richiedere un URL di caricamento in un commento privato.

Le risposte in questo commento sono soggette allo stesso limite di visibilità specificata, anche se l'elenco a discesa per il controllo nelle risposte non visualizza correttamente lo stato di visibilità limitata.

Per tutelare la privacy e impedire la visualizzazione pubblica delle informazioni riservate, prestare attenzione. Limitare tutte le interazioni con Microsoft alle risposte sotto il commento con restrizioni. Le risposte ad altri commenti potrebbero accidentalmente divulgare informazioni riservate.

Come segnalare un problema di documentazione di C++

Utilizziamo i problemi GitHub per tenere traccia dei problemi segnalati nella nostra documentazione. È ora possibile creare problemi in GitHub direttamente da una pagina contenuto, che consente di interagire in modo molto più efficace con gli autori e i team di prodotto. Se si nota un problema in un documento, un esempio di codice non valido, una spiegazione confusa, una mancanza critica o semplicemente un errore di ortografia, è possibile segnalare facilmente il problema. Scorrere fino alla fine della pagina e selezionare Sign in to give documentation feedback (Accedi per fornire commenti e suggerimenti sulla documentazione). È necessario creare un account GitHub, se non è già disponibile. Con un account GitHub è possibile visualizzare tutti i problemi relativi alla documentazione e il relativo stato. Si ricevono inoltre notifiche quando vengono apportate modifiche per l'errore segnalato. Per altre informazioni, vedere la voce di blog di Feedback System.

Si crea un problema relativo alla documentazione in GitHub quando si usa il pulsante per l'invio di commenti e suggerimenti relativi alla documentazione. Il problema viene compilato automaticamente con alcune informazioni relative alla pagina in cui viene creato. Questo è il modo in cui Microsoft può risalire alla posizione del problema, quindi non modificare queste informazioni. Aggiungere solo i dettagli sull'errore ed eventualmente suggerire una correzione. La documentazione di C++ è open source, pertanto è possibile inviare una correzione, se lo si desidera. Per ulteriori informazioni su come contribuire alla documentazione, vedere la nostra Contributing guide (Guida ai contributi) su GitHub.