/Z7, /Zi, /ZI (формат отладочной информации)

Обновлен: Ноябрь 2007

Задают тип отладочной информации, создаваемой для программы, и место хранения этой информации: объектные файлы (OBJ) или база данных программы (PDB).

 /Z{7|i|I}

Заметки

Данные параметры описаны в следующей таблице:

  • Параметры отсутствуют
    Отладочная информация не создается, и компиляция производится быстрее.

  • /Z7
    Создается файл OBJ, содержащий полную символьную отладочную информацию и используемый отладчиком. Символьная отладочная информация содержит имена и типы переменных, а также функции и номера строк. Файл PDB не создается.

    Отсутствие файла PDB может обеспечивать преимущество для распространителей библиотек, создаваемых третьей стороной. Тем не менее, на этапе компоновки и отладки необходимы файлы OBJ для предкомпилированных заголовков. Если в объектных файлах PCH присутствует только информация о типах (без кода), то компиляцию будет необходимо провести с параметром Параметр /Yl (вставка ссылки на PCH-файл для библиотеки отладки).

  • /Zi
    Создается база данных программы (PDB), содержащая информацию о типах и символьную отладочную информацию и используемая отладчиком. Символьная отладочная информация содержит имена и типы переменных, а также функции и номера строк.

    Параметр /Zi не влияет на оптимизацию. Тем не менее, параметр /Zi подразумевает параметр /debug; дополнительные сведения см. в разделе /DEBUG (создать отладочную информацию).

    Информация о типах размещается в файле PDB, а не в файле OBJ.

    С параметром /Zi можно использовать параметр /Gm (включение минимального перепостроения); в то же время параметр /Gm нельзя использовать при компиляции с параметром /Z7.

    При компиляции с параметрами /Zi и /clr атрибут DebuggableAttribute не будет помещаться в метаданные сборки; при необходимости его следует задать в исходном коде. Этот атрибут может повлиять на производительность приложения во время выполнения. Дополнительные сведения о том, как атрибут Debuggable влияет на производительность, и том, как можно скомпенсировать его эффект, см. в разделе Упрощение отладки образов.

  • /ZI
    В соответствии с приведенным выше описанием создается база данных программы, имеющая формат, поддерживающий функцию "Изменить и продолжить". Если необходимо использовать режим "Изменить и продолжить", то этот параметр должен быть использован. Поскольку большинство видов оптимизации несовместимо с функцией "Изменить и продолжить", использование параметра /ZI отменяет любые инструкции #pragma optimize в коде.

    Использование параметра /ZI приводит к тому, что при компиляции также используется параметр /Gy (включение компоновки на уровне функций).

    Параметр /ZI несовместим с параметром /clr (компиляция CLR).

    958x11bc.alert_note(ru-ru,VS.90).gifПримечание.

    Параметр /ZI доступен только при компиляции для целевой архитектуры x86; этот параметр компилятора недоступен в компиляторах для целевых платформ x64 или семейства процессоров Itanium (IPF).

Компилятор дает базе данных программы имя проект.pdb. При компиляции файла вне проекта компилятор создает базу данных с именем VCx0.pdb, где x — это основной номер используемой версии Visual C++. Компилятор внедряет имя базы данных PDB во все файлы OBJ, созданные с помощью этого параметра, указывая отладчику на местоположение символьной информации и информации о номерах строк. При использовании этого параметра файлы OBJ будут иметь более компактные размеры, поскольку отладочная информация хранится в файле PDB, а не в файлах OBJ.

При создании библиотеки из объектных файлов, созданных с помощью этого параметра, связанный с ними файл PDB должен быть доступен при компоновке программы с библиотекой. Это означает, что вместе с библиотекой следует распространять и файл PDB.

Чтобы создать библиотеку, содержащую отладочную информацию, без использования файлов PDB, необходимо использовать параметр компилятора, включающий режим совместимости с C 7.0 (/Z7). При использовании параметров, связанных с предкомпилированными заголовками, в файл PDB заносится отладочная информация как для предкомпилированного заголовка, так и для оставшегося исходного кода. При указании параметра базы данных программы параметр /Yd пропускается.

Установка параметра компилятора в среде разработки Visual Studio

  1. Откройте диалоговое окно Страницы свойств проекта. Дополнительные сведения см. в разделе Открытие свойств страниц проекта.

  2. Щелкните папку C/C++.

  3. Щелкните страницу свойств Общие.

  4. Измените значение свойства Формат отладочной информации.

Установка параметра компилятора программным способом

См. также

Ссылки

Параметры компилятора

Настройка параметров компилятора