Compartilhar via


/ /Z7, /Zi, /ZI (formato informações de depuração)

Select the type of debugging information created for your program and whether this information is kept in object (.obj) files or in a program database (PDB).

/Z{7|i|I}

Comentários

As opções são descritas na tabela a seguir.

  • None
    Não produz nenhuma informação de depuração, para que a compilação é mais rápida.

  • /Z7
    Produz um arquivo. obj, contendo informações de depuração toda simbólicas para uso com o depurador. Informações de depuração simbólicas incluem os nomes e tipos de variáveis, bem como funções e os números de linha. Nenhum arquivo. PDB é produzido.

    Para distribuidores de bibliotecas de terceiros, há uma vantagem de não ter um arquivo. PDB. No entanto, os arquivos. obj dos cabeçalhos pré-compilados são necessárias durante a fase de link e depuração. Se houver só pode digitar informações (e nenhum código) nos arquivos de objeto .pch, você também precisará compilar com /Yl (inserir a referência PCH para a biblioteca de depuração).

  • /Zi
    Produz um banco de dados do programa (PDB) que contém informações sobre o tipo e informações de depuração simbólicas para uso com o depurador. Informações de depuração simbólicas incluem os nomes e tipos de variáveis, bem como funções e os números de linha.

    /Zinão afeta otimizações. No entanto, /Zi implica /debug; consulte /Debug (gerar informações de depuração) para obter mais informações.

    Informações de tipo são colocadas no arquivo. PDB e não no arquivo. obj.

    Você pode usar /GM (Habilitar recompilação mínima) com /Zi, enquanto /Gm não está disponível durante a compilação com /Z7.

    Durante a compilação com /Zi e /clr, o DebuggableAttribute atributo não será colocado nos metadados do assembly; Você deve especificá-lo no código fonte, se desejar que ele. Esse atributo pode afetar o desempenho de tempo de execução do aplicativo. Para obter mais informações sobre como o atributo depurável afeta o desempenho e como você pode modificar o impacto no desempenho, consulte Facilitando uma imagem depurar.

  • /ZI
    Produces a program database, as described above, in a format that supports the Edit and Continue feature. Se você deseja usar Edit and Continue a depuração, você deve usar essa opção. Porque a maioria das otimizações são incompatíveis com o Edit and Continue, usando /ZI desativa qualquer #pragma optimize as instruções em seu código.

    /ZIfaz com que /GY (nível de função para ativar a vinculação) e /FC (caminho completo do arquivo de código-fonte no diagnóstico) a ser usado na compilação.

    /ZInão é compatível com /CLR (common Language Runtime Compilation).

    ObservaçãoObservação

    /ZIsó está disponível no compilador x86; Esta opção de compilador não está disponível nos compiladores direcionamento x64 ou a família de processadores Itanium (IPF).

O compilador nomeia o banco de dados do programa projeto. PDB. Se você compilar um arquivo sem um projeto, o compilador cria um banco de dados chamado VCxPDB., onde x é a versão principal do Visual C++ em uso. O compilador incorpora o nome do PDB em cada arquivo. obj, criado com essa opção, o depurador de apontando para o local das informações simbólicos e o número da linha. Quando você usar esta opção, os arquivos. obj será menores, porque as informações de depuração é armazenada no arquivo. PDB, em vez de fazê-lo em arquivos. obj.

Se você criar uma biblioteca de objetos que foram compilados com o uso desta opção, o arquivo. PDB de associado deve estar disponível quando a biblioteca está vinculada a um programa. Assim, se você distribuir a biblioteca, você deve distribuir o PDB.

Para criar uma biblioteca que contém informações de depuração sem usar arquivos. PDB, você deve selecionar c do compilador compatível com 7.0 (/Z7) opção. Se você usar as opções de cabeçalhos pré-compilados, informações de depuração para o cabeçalho pré-compilado e o restante do código-fonte é colocada no PDB. O /Yd opção é ignorada quando a opção de banco de dados do programa é especificada.

Para definir esta opção de compilador no ambiente de desenvolvimento Visual Studio

  1. Abra o projeto Property Pages caixa de diálogo. For details, see Como: Abrir páginas de propriedades do projeto.

  2. Clique o C/C++ pasta.

  3. Clique o Geral página de propriedades.

  4. Modificar o Formato de informações de depuração propriedade.

Para definir esta opção de compilador programaticamente

Consulte também

Referência

Opções do compilador

Definindo opções do compilador