Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Met de /DEBUG linkeroptie maakt u een informatiebestand voor foutopsporing voor het uitvoerbare bestand.
Syntaxis
/DEBUG[:{FASTLINK||FULLNONE}]
Opmerkingen
Met de /DEBUG optie worden de foutopsporingsgegevens uit gekoppelde object- en bibliotheekbestanden in een PDB-bestand (Program Database) geplaatst. De PDB wordt bijgewerkt tijdens volgende builds van het programma.
Een uitvoerbaar bestand (een EXE- of DLL-bestand) dat is gemaakt voor foutopsporing, bevat de naam en het pad van de bijbehorende PDB. Het foutopsporingsprogramma leest de ingesloten naam en gebruikt de PDB bij het opsporen van fouten in het programma. De linker gebruikt de basisnaam van het programma en de extensie .pdb om de programmadatabase een naam te geven en sluit het pad in waar het is gemaakt. Als u deze standaardwaarde wilt overschrijven, stelt u de /PDB optie in en geeft u een andere bestandsnaam op.
Opmerking
De /DEBUG:FASTLINK optie is afgeschaft en verwijderd vanaf Visual Studio 2026. Het was beschikbaar in Visual Studio 2017 tot en met Visual Studio 2022.
/DEBUG:FASTLINK een beperkte PDB gegenereerd die indexeert in de foutopsporingsgegevens in de objectbestanden en -bibliotheken die worden gebruikt om het uitvoerbare bestand te bouwen in plaats van een volledige kopie te maken. U kunt deze beperkte PDB alleen gebruiken om fouten op te sporen vanaf de computer waarop het binaire bestand en de bijbehorende bibliotheken zijn gebouwd. Als u het binaire bestand ergens anders implementeert, kunt u fouten opsporen op afstand vanaf de buildcomputer, maar niet rechtstreeks op de testcomputer. Sinds Visual Studio 2019 zijn de /DEBUG:FULL koppelingstijden aanzienlijk verbeterd en /DEBUG:FASTLINK is het niet altijd sneller dan /DEBUG:FULL. Omdat /DEBUG:FASTLINK er geen grote verbeteringen in de buildtijd meer worden geboden en resulteert in een tragere foutopsporingservaring versus /DEBUG:FULL, wordt deze optie niet meer aanbevolen en wordt deze verwijderd in Visual Studio 2026. Liever gebruiken /DEBUG:FULL.
Een /DEBUG:FASTLINK PDB kan worden geconverteerd naar een volledige PDB die u kunt implementeren op een testcomputer voor lokale foutopsporing. Gebruik in Visual Studio het dialoogvenster Eigenschappenpagina's zoals hieronder wordt beschreven om een volledige PDB te maken voor het project of de oplossing. In een opdrachtprompt voor ontwikkelaars kunt u het mspdbcmf.exe hulpprogramma gebruiken om een volledige PDB te maken.
De /DEBUG:FULL optie verplaatst alle persoonlijke symboolgegevens van afzonderlijke compilatieproducten (objectbestanden en bibliotheken) naar één PDB en kunnen het meest tijdrovende deel van de koppeling zijn. De volledige PDB kan echter worden gebruikt om fouten in het uitvoerbare bestand op te sporen wanneer er geen andere buildproducten beschikbaar zijn, zoals wanneer het uitvoerbare bestand wordt geïmplementeerd.
Met de /DEBUG:NONE optie wordt geen PDB gegenereerd.
/DEBUG Opgeven zonder extra argumenten is gelijk aan het /DEBUG:FULLopgeven van .
De optie (C7 Compatibel) van /Z7 de compiler zorgt ervoor dat de compiler de foutopsporingsgegevens in de objectbestanden (OBJ) laat staan. U kunt ook de /Zi compileroptie (Program Database) gebruiken om de foutopsporingsgegevens op te slaan in een PDB voor het OBJ-bestand. De linker zoekt eerst naar de PDB van het object in het absolute pad dat is geschreven in het OBJ-bestand en vervolgens in de map die het OBJ-bestand bevat. U kunt de PDB-bestandsnaam of -locatie van een object niet opgeven op de linker.
/INCREMENTAL wordt geïmpliceerd wanneer /DEBUG wordt opgegeven.
/DEBUGwijzigt de standaardwaarden voor de optie van REF en van naar NOREFICF, NOICFdus als u de oorspronkelijke standaardwaarden wilt, moet u expliciet opgeven /OPT:REF of /OPT:ICF na de /DEBUG/OPT optie.
Het is niet mogelijk om een EXE of DLL te maken die foutopsporingsgegevens bevat. Foutopsporingsgegevens worden altijd in een OBJ- of PDB-bestand geplaatst.
Deze linkeroptie instellen in de Ontwikkelomgeving van Visual Studio
- Het dialoogvenster Eigenschappenpagina's van het project openen. Zie C++ compiler en buildeigenschappen instellen in Visual Studio voor meer informatie.
- Selecteer de eigenschappenpaginaLinker-foutopsporing>.
- Wijzig de eigenschap Foutopsporingsgegevens genereren om PDB-generatie in of uit te schakelen. Deze eigenschap is
/DEBUG:FASTLINKstandaard ingeschakeld in Visual Studio 2017 en hoger. - Wijzig de eigenschap Volledig programmadatabasebestand genereren om volledige PDB-generatie in te schakelen
/DEBUG:FULLvoor elke incrementele build.