/DEBUG (Gerar informações de depuração)

A /DEBUG opção vinculador cria um arquivo de informações de depuração para o executável.

Sintaxe

/DEBUG[:{FASTLINK||FULLNONE}]

Observações

A /DEBUG opção coloca as informações de depuração de objetos vinculados e arquivos de biblioteca em um arquivo de banco de dados de programa (PDB). Ele atualiza o PDB durante as compilações subsequentes do programa.

Um executável (um arquivo EXE ou DLL) criado para depuração contém o nome e o caminho do PDB correspondente. O depurador lê o nome incorporado e usa o PDB quando você depurar o programa. O vinculador usa o nome base do programa e a extensão .pdb para nomear o banco de dados do programa e incorpora o caminho onde ele foi criado. Para substituir esse padrão, defina a /PDB opção e especifique um nome de arquivo diferente.

Observação

A /DEBUG:FASTLINK opção foi preterida e removida a partir do Visual Studio 2026. Ele estava disponível no Visual Studio 2017 através do Visual Studio 2022.

/DEBUG:FASTLINK gerou um PDB limitado que indexa as informações de depuração nos arquivos de objeto e bibliotecas usadas para construir o executável em vez de fazer uma cópia completa. Você só pode usar esse PDB limitado para depurar do computador onde o binário e suas bibliotecas foram construídos. Se você implantar o binário em outro lugar, poderá depurá-lo remotamente a partir do computador de compilação, mas não diretamente no computador de teste. Desde o Visual Studio 2019, /DEBUG:FULL os tempos de vinculação melhoraram significativamente e /DEBUG:FASTLINK nem sempre são mais rápidos do que /DEBUG:FULLo . Como /DEBUG:FASTLINK não fornece mais grandes melhorias no tempo de compilação e resulta em uma experiência de depuração mais lenta versus /DEBUG:FULL, essa opção não é mais recomendada e é removida no Visual Studio 2026. Prefira usar o /DEBUG:FULL.

Um /DEBUG:FASTLINK PDB pode ser convertido em um PDB completo que você pode implantar em uma máquina de teste para depuração local. No Visual Studio, use a caixa de diálogo Páginas de propriedades conforme descrito abaixo para criar um PDB completo para o projeto ou solução. Em um prompt de comando do desenvolvedor, você pode usar a mspdbcmf.exe ferramenta para criar um PDB completo.

A /DEBUG:FULL opção move todas as informações de símbolos privados de produtos de compilação individuais (arquivos de objetos e bibliotecas) para um único PDB e pode ser a parte mais demorada do link. No entanto, o PDB completo pode ser usado para depurar o executável quando nenhum outro produto de compilação estiver disponível, como quando o executável é implantado.

A /DEBUG:NONE opção não gera um APO.

Especificar /DEBUG sem argumentos extras equivale a especificar /DEBUG:FULL.

A opção do /Z7 compilador (compatível com C7) faz com que o compilador deixe as informações de depuração nos arquivos de objeto (OBJ). Você também pode usar a /Zi opção de compilador (Program Database) para armazenar as informações de depuração em um PDB para o arquivo OBJ. O vinculador procura o PDB do objeto primeiro no caminho absoluto escrito no arquivo OBJ e, em seguida, no diretório que contém o arquivo OBJ. Não é possível especificar o nome do arquivo PDB ou o local de um objeto para o vinculador.

/INCREMENTAL está implícito quando /DEBUG é especificado.

/DEBUG altera os padrões /OPT da opção de REF para NOREF e de ICF para NOICF, portanto, se você quiser os padrões originais, deverá especificar /OPT:REF explicitamente ou /OPT:ICF após a /DEBUG opção.

Não é possível criar um EXE ou DLL que contenha informações de depuração. As informações de depuração são sempre colocadas em um arquivo OBJ ou PDB.

Para definir essa opção de vinculador no ambiente de desenvolvimento do Visual Studio

1. Abra a caixa de diálogo Páginas de propriedades do projeto. Para obter detalhes, consulte Definir compilador C++ e criar propriedades no Visual Studio.
2. Selecione a páginade propriedades Depuração dovinculador>.
3. Modifique a propriedade Generate Debug Info para habilitar ou desabilitar a geração de PDB. Essa propriedade habilita /DEBUG:FASTLINK por padrão no Visual Studio 2017 e posterior.
4. Modifique a propriedade Generate Full Program Database File para habilitar /DEBUG:FULL a geração completa de PDB para cada compilação incremental.

Para definir essa opção de vinculador programaticamente

1. Consulte GenerateDebugInformation.

Consulte também

Referência do vinculador MSVC
Opções do vinculador MSVC