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ç>>>> 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:
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:
İ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çı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.
#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. |
nonesuggestionwarningerror |
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. |
nonesuggestionwarningerrordimmed |
cpp_include_cleanup_remove_unused_error_tag_type = dimmed |
cpp_include_cleanup_excluded_files
Belirtilen dosyaları Temizlemeyi Ekle iletilerinin dışında tutar. Başlıkla ilgili ne ekleme ne de kullanılmadığına dair bir öneri almayacaksınız. |
filename | 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 <cstdio> içeren bir dosyanız varsa ve yalnızca 'den #include <stdio.h>içerik tüketirseniz, temizlemeyi dahil et ayarı işlem sırasında ile stdio.hstdio.h değiştirildiği için kaldırmanızı cstdiostdio.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