/DEBUG (Generera felsökningsinformation)

Alternativet /DEBUG linker skapar en felsökningsinformationsfil för den körbara filen.

Syntax

/DEBUG[:{FASTLINK||FULLNONE}]

Anmärkningar

Alternativet /DEBUG placerar felsökningsinformationen från länkade objekt- och biblioteksfiler i en programdatabasfil (PDB). Det uppdaterar PDB under efterföljande versioner av programmet.

En körbar fil (en EXE- eller DLL-fil) som skapats för felsökning innehåller namnet och sökvägen för motsvarande PDB. Felsökningsprogrammet läser det inbäddade namnet och använder PDB när du felsöker programmet. Länkaren använder basnamnet för programmet och tillägget .pdb för att namnge programdatabasen och bäddar in sökvägen där det skapades. Om du vill åsidosätta den här standardinställningen anger du alternativet /PDB och anger ett annat filnamn.

/DEBUG:FASTLINK genererade ett begränsat PDB som indexerar i felsökningsinformationen i objektfilerna och biblioteken som används för att skapa den körbara filen i stället för att göra en fullständig kopia. Du kan bara använda detta begränsade PDB för att felsöka från datorn där binärfilen och dess bibliotek skapades. Om du distribuerar binärfilen någon annanstans kan du felsöka den via fjärranslutning från byggdatorn, men inte direkt på testdatorn. Sedan Visual Studio 2019 /DEBUG:FULL har länkningstiderna förbättrats avsevärt och /DEBUG:FASTLINK är inte alltid snabbare än /DEBUG:FULL. Eftersom /DEBUG:FASTLINK inte längre ger förbättringar av byggtiden och resulterar i en långsammare felsökning jämfört /DEBUG:FULLmed , rekommenderas inte längre det här alternativet och tas bort i Visual Studio 2026. Föredrar att använda /DEBUG:FULL.

En /DEBUG:FASTLINK PDB kan konverteras till ett fullständigt PDB som du kan distribuera till en testdator för lokal felsökning. I Visual Studio använder du dialogrutan Egenskapssidor enligt beskrivningen nedan för att skapa ett fullständigt PDB för projektet eller lösningen. I en kommandotolk för utvecklare kan du använda mspdbcmf.exe verktyget för att skapa en fullständig PDB.

Alternativet /DEBUG:FULL flyttar all privat symbolinformation från enskilda kompileringsprodukter (objektfiler och bibliotek) till en enda PDB och kan vara den mest tidskrävande delen av länken. Den fullständiga PDB:n kan dock användas för att felsöka den körbara filen när inga andra byggprodukter är tillgängliga, till exempel när den körbara filen distribueras.

Alternativet /DEBUG:NONE genererar inte ett PDB.

Att /DEBUG ange utan extra argument motsvarar att ange /DEBUG:FULL.

Kompilatorns /Z7 (C7-kompatibla) alternativ gör att kompilatorn lämnar felsökningsinformationen i objektfilerna (OBJ). Du kan också använda kompilatoralternativet /Zi (Program Database) för att lagra felsökningsinformationen i en PDB för OBJ-filen. Länkaren söker först efter objektets PDB i den absoluta sökvägen som skrivits i OBJ-filen och sedan i katalogen som innehåller OBJ-filen. Du kan inte ange ett objekts PDB-filnamn eller plats för länkaren.

/INCREMENTAL är underförstådd när /DEBUG anges.

/DEBUG ändrar standardinställningarna för /OPT alternativet från REF till NOREF och från ICF till NOICF, så om du vill ha de ursprungliga standardvärdena måste du uttryckligen ange /OPT:REF eller /OPT:ICF efter alternativet /DEBUG .

Det går inte att skapa en EXE eller DLL som innehåller felsökningsinformation. Felsökningsinformation placeras alltid i en OBJ- eller PDB-fil.

Ange det här länkalternativet i Visual Studio-utvecklingsmiljön

1. Öppna dialogrutan Egenskapssidor för projektet. Mer information finns i Ange C++-kompilator- och byggegenskaper i Visual Studio.
2. Välj egenskapssidanLänkfelsökning>.
3. Ändra egenskapen Generera felsökningsinformation för att aktivera eller inaktivera PDB-generering. Den här egenskapen aktiverar /DEBUG:FASTLINK som standard i Visual Studio 2017 och senare.
4. Ändra egenskapen Generera fullständig programdatabasfil för att aktivera /DEBUG:FULL fullständig PDB-generering för varje inkrementell version.

Så här ställer du in det här länkalternativet programmatiskt

1. Se även GenerateDebugInformation.

Se även

REFERENS FÖR MSVC-länkare
ALTERNATIV för MSVC-länkare