Aracılığıyla paylaş


Visual Studio'da C/C++ Temizleme ekle'yi yapılandırma

Visual Studio, 17.8 Önizleme 1'den başlayarak C ve C++ kodunuzun kalitesini aşağıdaki yollarla geliştirmek için s kodunuzu temizleyebilir #include:

  • Yalnızca gerekli bir üst bilgi dosyası başka bir üst bilgi dosyası tarafından dolaylı olarak eklendiğinden derlenen kod için üst bilgi dosyaları ekleme teklifi sunar.
  • Kullanılmayan üst bilgi dosyalarını kaldırmayı ve derleme sürelerini iyileştirmeyi sunar.

Bu makalede, Visual Studio'da Temizlemeyi Dahil Et'in nasıl yapılandırıldığı açıklanır. Temizlemeyi Dahil Et hakkında daha fazla bilgi için bkz . C/C++ Temizlemeyi Dahil Et'e genel bakış.

Temizlemeyi Dahil Et'i açma

Temizlemeyi Dahil Et özelliği varsayılan olarak açıktır. Etkin değilse, Araç>Seçenekleri>Metin Düzenleyicisi>C/C++>Kod Temizleme aracılığıyla açabilir ve #include temizlemeyi etkinleştir'i seçebilirsiniz.

Ardından, dolaylı üst bilgiler ekleme veya kullanılmayan üst bilgileri kaldırma fırsatları hakkında nasıl bildirim almak istediğinizi yapılandırmak için açılan menüleri kullanın:

The Tools options dialog opened at Text Editor > C/C++ > Code Cleanup.

Etkinleştir # temizlemeyi dahil et onay kutusu işaretlidir. Kullanılmayanları kaldır seçeneği öneri düzeyi içerir ve Eksik ekle öneri düzeyi açılır listelerinde gösterilir. Açılan menü içeriği gösterilir ve bunlar şunlardır: **Yalnızca yeniden düzenleme**, **Öneri**, **Uyarı**ve **Hata**. **Kullanılmayanları kaldır öneri düzeyi içerir** açılan listesi aynı seçenekleri sunar ancak soluk da ekler.

Öneri düzeyi seçeneklerinin anlamları şunlardır:

Yalnızca yeniden düzenleme: Temizlemeyi Ekle seçeneği, fare işaretçisini bir #includeöğesinin üzerine getirdiğinizde veya imleci çizginin #include üzerine getirip Ctrl+nokta tuşlarına bastığınızda hızlı işlem menüsünde gerçekleştirebileceğiniz eylemler sunar:

A screenshot of the quick action to remove an unused header

İmleci #include iostream öğesinin üzerine getirdiğinizde, bu dosyada # include iostream metnini içeren bir ampul görüntülenmez."

Öneri, Uyarı, Hata: Temizleme tekliflerini dahil et, Hata Listesi penceresinde öneriler, uyarılar veya hatalar aracılığıyla gerçekleştirebileceği eylemler sunar. Hangisinin olduğunu siz belirlersiniz. Hata Listesi'nin aşağıdaki ekran görüntüsünde Temizlemeyi Dahil Et, kullanılmayan üst bilgileri bir uyarıyla gösterecek şekilde yapılandırılmıştır. Temizlemeyi Dahil Et çıkışını görebilmek için açılan filtrede Build + Intellisense'in seçili olduğundan emin olun:

A screenshot of the Error List window.

Açılan filtre Build + IntelliSense olarak ayarlanır. Bir uyarı görünür: VCIC002 - #include < iostream > bu dosyada kullanılmaz."

Soluk

Temizlemeyi Dahil Et, kullanılmayan üst bilgi dosyasının satırını kod düzenleyicisinde soluk görüntüleyerek kullanılmayan üst bilgileri gösterir. İmlecinizi soluk #include olan seçeneğin üzerine getirerek hızlı işlem menüsünü açın ve Olası düzeltmeleri göster'i seçin veya kullanılmayan dosyayla ilgili eylemleri görmek için ampul açılan menüsüne tıklayın.

A screenshot of a dimmed #include < iostream > line.

#include < iostream > satırı, iostream kullanan kod satırı açıklama satırına eklendiğinden soluk görüntülenir. Bu kod satırı :/ std::cout << "charSize = " << charSize; Bu satır için hızlı işlem menüsü de görünür. #include < iostream > bu dosyada kullanılmadığını ve Olası düzeltmeleri göster bağlantısının olduğunu söyler.

Temizlemeyi Dahil Et'i ile yapılandırma .editorconfig

Temizlemeyi Dahil Et'i yapılandırmak için, belirtilen eklemeleri temizleme önerilerinden dışlama gibi daha fazla seçenek vardır. Bu, aracın bunları kullanılmamış olarak işaretlememesi için bazı üst bilgi dosyalarının gerekli olduğunu gösterir ve bu şekilde devam eder. Bu seçenekler, kod tabanında çalışan herkes için tutarlı kodlama stilleri uygulayabileceğiniz, projenize ekleyebileceğiniz bir .editorconfig dosyada tanımlanır. Projenize dosya ekleme .editorconfig hakkında daha fazla bilgi için bkz . EditorConfig ile taşınabilir, özel düzenleyici ayarları oluşturma.

Temizlemeyi .editorconfig Dahil Et ile kullanabileceğiniz ayarlar şunlardır:

Ayar Değerler Örnek
cpp_include_cleanup_add_missing_error_tag_type

Geçişli ekleme iletilerinin hata düzeyini ayarlar.
none
suggestion
warning
error
cpp_include_cleanup_add_missing_error_tag_type = suggestion
cpp_include_cleanup_remove_unused_error_tag_type

Kullanılmayan ekleme iletilerini kaldırma hata düzeyini ayarlar.
none
suggestion
warning
error
dimmed
cpp_include_cleanup_remove_unused_error_tag_type = dimmed
cpp_include_cleanup_excluded_files

Belirtilen dosyaları Temizlemeyi Ekle iletilerinin dışında tutar. Ekleme veya kullanılmamış olması fark etmez, üst bilgiyle ilgili bir öneri almazsınız.
Dosyaadı cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h
cpp_include_cleanup_required_files

file1 kullanımının file2 gerektirdiğini belirtin. Örneğin, kullanıyorsanız atlwin.h bunun altbase.h da dahil edilmesi gerektiğini belirtin.
dosya1:dosya2 cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h
cpp_include_cleanup_replacement_files

Temizlemeyi Dahil Et işlemi sırasında file1 dosyasını dosya2 ile değiştirir. Örneğin yerine kullanmayı cstdiostdio.htercih edebilirsiniz. Hem hem de #include <cstudio> içeren bir dosyanız varsa ve yalnızca 'den stdio.hiçerik tüketirseniz, temizlemeyi dahil et ayarı işlem sırasında ile stdio.hcstdio değiştirildiği için kaldırmanızı stdio.h#include <stdio.h> söyler. İçeriğini ikisinden de kullanmıyorsanız, Temizlemeyi Dahil Et her ikisini de kaldırmanızı söyler.
dosya1:dosya2 cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint
cpp_include_cleanup_alternate_files

Dosya1 dahilse dolaylı ekleme dosyası2 için ileti oluşturmayın. Örneğin, siz ve yalnızca #include <windows.h> dolaylı olarak dahil edilen üst bilgisinden winerror.hbir şey kullanıyorsanız, Temizlemeyi Dahil Et özelliği eklemek winerror.histeyip istemediğinizi sormaz. Dolaylı dahil etmek yerine bir cephe üst bilgisi dosyası eklemeyi tercih ettiğinizde kullanışlıdır.
dosya1:dosya2 cpp_include_cleanup_alternate_files = windows.h:winerror.h, windows.h:minwindef.h

Ayrıca bkz.

C/C++ Temizlemeye genel bakış
Temizleme iletilerini dahil et