/DEBUG (Generování informací o ladění)

Možnost /DEBUG linkeru vytvoří pro spustitelný soubor s informacemi o ladění.

Syntaxe

/DEBUG[:{FASTLINK||FULLNONE}]

Poznámky

Možnost /DEBUG umístí informace o ladění z propojených objektů a souborů knihovny do souboru databáze programu (PDB). Aktualizuje soubor PDB během následných sestavení programu.

Spustitelný soubor (soubor EXE nebo DLL) vytvořený pro ladění obsahuje název a cestu odpovídající pdB. Ladicí program přečte vložený název a při ladění programu použije pdB. Linker používá základní název programu a rozšíření .pdb k pojmenování databáze programu a vloží cestu, do které byla vytvořena. Pokud chcete toto výchozí nastavení přepsat, nastavte /PDB možnost a zadejte jiný název souboru.

Poznámka:

Tato /DEBUG:FASTLINK možnost je zastaralá a odebraná od sady Visual Studio 2026. Byl k dispozici v sadě Visual Studio 2017 až Visual Studio 2022.

/DEBUG:FASTLINK vygeneroval omezený soubor PDB, který indexuje do ladicí informace v souborech objektů a knihovnách použitých k sestavení spustitelného souboru místo vytvoření úplné kopie. Tento omezený soubor PDB můžete použít pouze k ladění z počítače, kde byl binární soubor a jeho knihovny sestaveny. Pokud binární soubor nasadíte jinde, můžete ho vzdáleně ladit z počítače sestavení, ale ne přímo na testovacím počítači. Od sady Visual Studio 2019 /DEBUG:FULL se doba propojení výrazně zlepšila a /DEBUG:FASTLINK není vždy rychlejší než /DEBUG:FULL. Vzhledem k tomu, že /DEBUG:FASTLINK již neposkytuje velká vylepšení času sestavení a výsledkem je pomalejší ladění oproti /DEBUG:FULLtomu, tato možnost se už nedoporučuje a je odebrána v sadě Visual Studio 2026. Raději používat /DEBUG:FULL.

Soubor /DEBUG:FASTLINK PDB lze převést na úplný soubor PDB, který můžete nasadit do testovacího počítače pro místní ladění. V sadě Visual Studio použijte dialogové okno Stránky vlastností, jak je popsáno níže, a vytvořte úplný soubor PDB pro projekt nebo řešení. V příkazovém řádku pro vývojáře můžete pomocí mspdbcmf.exe nástroje vytvořit úplný soubor PDB.

Tato /DEBUG:FULL možnost přesune všechny informace o privátních symbolech z jednotlivých kompilačních produktů (souborů objektů a knihoven) do jediného SOUBORU PDB a může být časově náročnou součástí odkazu. Úplný soubor PDB lze však použít k ladění spustitelného souboru, pokud nejsou k dispozici žádné jiné produkty sestavení, například při nasazení spustitelného souboru.

Tato /DEBUG:NONE možnost nevygeneruje pdb.

Zadání /DEBUG bez argumentů navíc odpovídá zadání /DEBUG:FULL.

Možnost kompilátoru /Z7 (kompatibilní s jazykem C7) způsobí, že kompilátor nechá informace o ladění v souborech objektu (OBJ). Můžete také použít možnost kompilátoru /Zi (Program Database) k uložení informací o ladění do SOUBORU PDB pro soubor OBJ. Linker nejprve vyhledá PDB objektu v absolutní cestě napsané v souboru OBJ a potom v adresáři, který obsahuje soubor OBJ. Do linkeru nemůžete zadat název souboru PDB objektu ani jeho umístění.

/INCREMENTAL je implicitní při /DEBUG zadání.

/DEBUGzmění výchozí hodnoty pro /OPT možnost z REFNOREF a z ICF do NOICF, takže pokud chcete původní výchozí hodnoty, musíte explicitně zadat /OPT:REF nebo /OPT:ICF za možností/DEBUG.

Nelze vytvořit exe nebo knihovnu DLL, která obsahuje informace o ladění. Ladicí informace se vždy umístí do souboru OBJ nebo PDB.

Nastavení tohoto parametru linkeru ve vývojovém prostředí sady Visual Studio

1. Otevřete dialogové okno Stránky vlastností projektu. Podrobnosti najdete v tématu Nastavení kompilátoru C++ a vlastností sestavení v sadě Visual Studio.
2. Vyberte stránku vlastností Ladění>.
3. Upravte vlastnost Generovat informace o ladění tak, aby povolovala nebo zakázala generování PDB. Tato vlastnost se /DEBUG:FASTLINK ve výchozím nastavení povolí v sadě Visual Studio 2017 a novějších verzích.
4. Upravte vlastnost Generate Full Program Database File (Vygenerovat soubor úplné databáze programu), aby bylo možné povolit /DEBUG:FULL úplné generování PDB pro každé přírůstkové sestavení.

Programové nastavení tohoto parametru linkeru

1. Viz třída GenerateDebugInformation.

Viz také

Referenční zdroje k linkeru MSVC
Možnosti linkeru MSVC