/DEBUG (Hata ayıklama bilgileri oluştur)

/DEBUG Bağlayıcı seçeneği yürütülebilir dosya için bir hata ayıklama bilgileri dosyası oluşturur.

Sözdizimi

/DEBUG[:{FASTLINK||FULLNONE}]

Açıklamalar

seçeneği, /DEBUG bağlı nesne ve kitaplık dosyalarındaki hata ayıklama bilgilerini bir program veritabanı (PDB) dosyasına yerleştirir. Programın sonraki derlemeleri sırasında PDB'yi güncelleştirir.

Hata ayıklama için oluşturulan yürütülebilir dosya (EXE veya DLL dosyası), ilgili PDB'nin adını ve yolunu içerir. Hata ayıklayıcı ekli adı okur ve programda hata ayıklarken PDB'yi kullanır. Bağlayıcı, program veritabanını adlandırmak için programın temel adını ve uzantısını .pdb kullanır ve oluşturulduğu yolu ekler. Bu varsayılanı geçersiz kılmak için seçeneğini ayarlayın /PDB ve farklı bir dosya adı belirtin.

Bu /DEBUG:FASTLINK seçenek Visual Studio 2017 ve sonraki sürümlerde kullanılabilir. Bu seçenek, tam kopya oluşturmak yerine yürütülebilir dosyayı oluşturmak için kullanılan nesne dosyalarında ve kitaplıklarında hata ayıklama bilgilerine dizin oluşturan sınırlı bir PDB oluşturur. Bu sınırlı PDB'yi yalnızca ikili dosya ve kitaplıklarının oluşturulduğu bilgisayardan hata ayıklamak için kullanabilirsiniz. İkiliyi başka bir yere dağıtırsanız, derleme bilgisayarından uzaktan hata ayıklarsınız, ancak doğrudan test bilgisayarında hata ayıklamazsınız. Visual Studio 2019'dan /DEBUG:FULL bu yana bağlama süreleri önemli ölçüde geliştirilmiştir ve /DEBUG:FASTLINK her zaman değerinden /DEBUG:FULLdaha hızlı değildir. Artık büyük derleme süresi geliştirmeleri sağlamadığından ve hata ayıklama deneyiminin /DEBUG:FULLdaha yavaş olmasına neden olmadığından/DEBUG:FASTLINK, bu seçenek artık önerilmez.

PDB /DEBUG:FASTLINK , yerel hata ayıklama için bir test makinesine dağıtabileceğiniz tam PDB'ye dönüştürülebilir. Visual Studio'da, proje veya çözüm için tam PDB oluşturmak üzere aşağıda açıklandığı gibi Özellik Sayfaları iletişim kutusunu kullanın. Geliştirici komut isteminde mspdbcmf.exe aracı kullanarak tam PDB oluşturabilirsiniz.

seçeneği, /DEBUG:FULL tek tek derleme ürünlerinden (nesne dosyaları ve kitaplıklar) tüm özel simge bilgilerini tek bir PDB'ye taşır ve bağlantının en çok zaman alan bölümü olabilir. Ancak, yürütülebilir dosyanın dağıtılması gibi başka bir derleme ürünü olmadığında yürütülebilir dosyanın hatalarını ayıklamak için tam PDB kullanılabilir.

seçeneği /DEBUG:NONE PDB oluşturmaz.

Ek bağımsız değişken olmadan belirtmek /DEBUG , belirtmekle /DEBUG:FULLeşdeğerdir.

Derleyicinin /Z7 (C7 Uyumlu) seçeneği, derleyicinin hata ayıklama bilgilerini nesne (OBJ) dosyalarında bırakmasına neden olur. Hata ayıklama bilgilerini OBJ dosyası için bir PDB'de depolamak için (Program Veritabanı) derleyici seçeneğini de kullanabilirsiniz /Zi . Bağlayıcı, nesnenin PDB'sini önce OBJ dosyasında yazılan mutlak yolda ve ardından OBJ dosyasını içeren dizinde arar. Bağlayıcı için nesnenin PDB dosya adını veya konumunu belirtemezsiniz.

/INCREMENTAL belirtildiğinde /DEBUG örtülür.

/DEBUG, seçeneğin /OPT varsayılanlarını ile REFNOREF arasında değiştirir, ICFNOICFbu nedenle özgün varsayılanları istiyorsanız, seçeneği açıkça veya /OPT:ICF sonra /DEBUG belirtmeniz /OPT:REF gerekir.

Hata ayıklama bilgilerini içeren bir EXE veya DLL oluşturmak mümkün değildir. Hata ayıklama bilgileri her zaman bir OBJ veya PDB dosyasına yerleştirilir.

Visual Studio geliştirme ortamındaki bu bağlayıcı seçeneğini ayarlamak için

1. Projenin Özellik Sayfaları iletişim kutusunu açın. Ayrıntılar için bkz . Visual Studio'da C++ derleyicisi ve derleme özelliklerini ayarlama.

2. Bağlayıcı>Hata Ayıklama özellik sayfasını seçin.

3. PDB oluşturmayı etkinleştirmek veya devre dışı bırakmak için Hata Ayıklama Bilgisi Oluştur özelliğini değiştirin. Bu özellik, Visual Studio 2017 ve sonraki sürümlerde varsayılan olarak etkinleştirir /DEBUG:FASTLINK .

4. Her artımlı derleme için tam PDB oluşturma özelliğini etkinleştirmek /DEBUG:FULL üzere Tam Program Veritabanı Dosyası Oluştur özelliğini değiştirin.

Bu bağlayıcı seçeneğini program aracılığıyla ayarlamak için

1. Bkz. GenerateDebugInformation.

Ayrıca bkz.

MSVC bağlayıcı başvurusu
MSVC bağlayıcı seçenekleri