Megosztás a következőn keresztül:


/DEBUG (Hibakeresési információk létrehozása)

A /DEBUG hivatkozáskezelő beállítás létrehoz egy hibakeresési információs fájlt a végrehajtható fájlhoz.

Szemantika

/DEBUG[:{FASTLINK||FULLNONE}]

Megjegyzések

A /DEBUG beállítás a csatolt objektum- és tárfájlok hibakeresési információit egy programadatbázis -fájlba (PDB) helyezi. Frissíti a PDB-t a program későbbi buildjei során.

A hibakereséshez létrehozott végrehajtható fájl (EXE- vagy DLL-fájl) tartalmazza a megfelelő PDF-fájl nevét és elérési útját. A hibakereső beolvassa a beágyazott nevet, és a program hibakeresésekor a PDB-t használja. A linker a program alapnevét és a bővítményt .pdb használja a programadatbázis elnevezésére, és beágyazza a létrehozási útvonalat. Az alapértelmezett beállítás felülbírálásához állítsa be a /PDB beállítást, és adjon meg egy másik fájlnevet.

Megjegyzés:

A /DEBUG:FASTLINK beállítás elavult, és a Visual Studio 2026-tól kezdve el lesz távolítva . A Visual Studio 2017-ben és a Visual Studio 2022-ben is elérhető volt.

/DEBUG:FASTLINK korlátozott PDB-t hozott létre, amely indexeli a hibakeresési információkat a végrehajtható objektumfájlokban és tárakban a teljes másolás helyett. Ezt a korlátozott PDF-fájlt csak abban a számítógépen végezheti el hibakeresésre, amelyen a bináris fájl és a kódtárak készültek. Ha a bináris fájlt máshol helyezi üzembe, a buildelési számítógépről távolról is hibakeresést végezhet, de közvetlenül a tesztszámítógépen nem. A Visual Studio 2019 /DEBUG:FULL óta a csatolási idők jelentősen javultak, és /DEBUG:FASTLINK nem mindig gyorsabbak, mint /DEBUG:FULL. Mivel /DEBUG:FASTLINK már nem biztosít nagy buildidő-fejlesztéseket, és lassabb hibakeresési élményt /DEBUG:FULLeredményez, ez a lehetőség már nem ajánlott, és a Visual Studio 2026-ban el lesz távolítva. Előnyben részesíti a használatát /DEBUG:FULL.

A /DEBUG:FASTLINK PDF-fájlok teljes PDB-vé alakíthatók, amelyet helyi hibakeresés céljából üzembe helyezhet egy tesztgépen. A Visual Studióban az alább ismertetett Tulajdonságlapok párbeszédpanelen hozzon létre egy teljes PDB-t a projekthez vagy megoldáshoz. A fejlesztői parancssorban az mspdbcmf.exe eszközzel létrehozhat egy teljes PDB-t.

A /DEBUG:FULL beállítás az egyes fordítási termékekből (objektumfájlokból és tárakból) származó összes privát szimbóluminformációt egyetlen PDF-fájlba helyezi át, és ez lehet a hivatkozás leg időigényesebb része. A teljes PDF-fájl azonban használható a végrehajtható fájl hibakeresésére, ha más buildtermékek nem érhetők el, például a végrehajtható fájl üzembe helyezésekor.

A /DEBUG:NONE beállítás nem hoz létre PDB-t.

A további argumentumok nélküli megadása /DEBUG egyenértékű a beállítással /DEBUG:FULL.

A fordító (C7 Kompatibilis) beállításával /Z7 a fordító az objektumfájlokban (OBJ) hagyja meg a hibakeresési információkat. A (Program Database) fordítóval a hibakeresési információkat az OBJ-fájl PDF-fájljában is /Zi tárolhatja. A linker először az OBJ-fájlban írt abszolút elérési úton keresi meg az objektum PDB-jét, majd az OBJ-fájlt tartalmazó könyvtárban. Nem adhatja meg egy objektum PDB-fájlnevét vagy helyét a hivatkozáshoz.

/INCREMENTAL kifejezés a megadott esetekben /DEBUG jelenik meg.

/DEBUGaz alapértelmezett beállításokat a beállítások között /OPTNOREFREF és között NOICFICF módosítja, ezért ha az eredeti alapértelmezett értékeket szeretné használni, explicit módon vagy utána kell megadnia /OPT:REF/OPT:ICF a /DEBUG beállítást.

Hibakeresési információkat tartalmazó EXE vagy DLL nem hozható létre. A hibakeresési információk mindig OBJ- vagy PDB-fájlba kerülnek.

A linker beállításának beállítása a Visual Studio fejlesztői környezetében

  1. Nyissa meg a projekt Tulajdonságlapok párbeszédpaneljét. További információ: C++ fordító és buildtulajdonságok beállítása a Visual Studióban.
  2. Válassza ki a Linker>hibakeresés tulajdonságlapja.
  3. Módosítsa a Hibakeresési információ létrehozása tulajdonságot a PDB-létrehozás engedélyezéséhez vagy letiltásához. Ez a tulajdonság alapértelmezés szerint engedélyezi /DEBUG:FASTLINK a Visual Studio 2017-ben és újabb verzióiban.
  4. Módosítsa a Teljes program adatbázisfájl létrehozása tulajdonságot, hogy minden növekményes build teljes PDB-generációját engedélyezze /DEBUG:FULL .

A hivatkozás beállításának programozott beállítása

  1. Lásd a(z) GenerateDebugInformation.

Lásd még

MSVC-csatoló referenciája
MSVC-csatoló beállításai