/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).
.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
Откройте диалоговое окно Страницы свойств проекта. Дополнительные сведения см. в разделе Открытие свойств страниц проекта.
Щелкните папку C/C++.
Щелкните страницу свойств Общие.
Измените значение свойства Формат отладочной информации.
Установка параметра компилятора программным способом
- См. раздел DebugInformationFormat.