{"id":33437,"date":"2024-01-08T16:21:52","date_gmt":"2024-01-08T16:21:52","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=33437"},"modified":"2024-01-08T16:21:52","modified_gmt":"2024-01-08T16:21:52","slug":"include-diagnostics-in-visual-studio","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/include-diagnostics-in-visual-studio\/","title":{"rendered":"#include Diagnostics\u00a0in Visual Studio"},"content":{"rendered":"

We\u2019re excited to announce that the #include Diagnostics feature is now available in Visual Studio 2022 17.9 Preview 2. This new feature allows you to better understand the behavior of #include directives by providing detailed information on each directive\u2019s references and build time.<\/span>\u00a0<\/span><\/p>\n

Download Visual Studio Preview<\/a><\/div><\/p>\n

\"Image<\/a><\/p>\n

To begin utilizing this feature, activate <\/span>#include diagnostics<\/span><\/b> by performing a right-click in your editor to display the context menu. Then, navigate to the \u2018Include Directives\u2019 option and choose \u2018Enable #include Diagnostics\u2019.<\/span>\u00a0<\/span><\/p>\n

#include References<\/span>\u00a0<\/span><\/h3>\n

The feature in Visual Studio allows you to analyze the usage of #include directives in your code. It shows where and how often each directive is referenced, which can be particularly useful when dealing with a long list of directives. If you find an #include directive that is infrequently used but significantly impacts your compile time, this tool will help you identify it quickly so you can take the necessary steps to optimize your code.<\/span>\u00a0<\/span><\/p>\n

Once you enable #include diagnostics, you should see a line of text above each #include directive. This is the CodeLens feature in action. The text above the #include directive indicates the count of its references in your current file. Clicking this count opens a window listing these references. Selecting any reference from this list will direct you to its corresponding line of code in your project.<\/span>\u00a0<\/span><\/p>\n

\"An<\/a><\/p>\n

#include Build Time<\/span><\/h3>\n

This feature presents the build time for each #include directive. To activate this, you\u2019ll need to run <\/span>Build Insights<\/span><\/a> by navigating to <\/span>Build <\/span><\/b>-> <\/span>Run Build Insights. <\/span><\/b>This action will generate the necessary build time data. <\/span>This allows you to easily visualize and evaluate the build time for each #include directive by comparing its usage and compilation time. The information provided by #include Diagnostics can be utilized to optimize your #include directives and improve compilation time. In addition to the information provided by the new #include diagnostics you may also want to consider checking out our documentation on <\/span>C++ modules<\/span><\/a> as an alternative to #include to further improve compilation time.<\/span><\/p>\n

\"A<\/a><\/p>\n

Send us your feedback\u00a0<\/span><\/h3>\n

Your feedback is invaluable to us as we strive to enhance your experience. Please feel free to leave your comments below. Alternatively, you can share your thoughts through the <\/span>Visual Studio Developer Community<\/span><\/a>. We\u2019re also available on Twitter (<\/span>@VisualC<\/span><\/a>) and can be reached via email at visualcpp@microsoft.com. We look forward to hearing from you!<\/span>\u00a0<\/span><\/p>\n

\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

We\u2019re excited to announce that the #include Diagnostics feature is now available in Visual Studio 2022 17.9 Preview 2. This new feature allows you to better understand the behavior of #include directives by providing detailed information on each directive\u2019s references and build time.\u00a0 To begin utilizing this feature, activate #include diagnostics by performing a right-click […]<\/p>\n","protected":false},"author":96741,"featured_media":33440,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-33437","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus"],"acf":[],"blog_post_summary":"

We\u2019re excited to announce that the #include Diagnostics feature is now available in Visual Studio 2022 17.9 Preview 2. This new feature allows you to better understand the behavior of #include directives by providing detailed information on each directive\u2019s references and build time.\u00a0 To begin utilizing this feature, activate #include diagnostics by performing a right-click […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/33437","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/96741"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=33437"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/33437\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/33440"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=33437"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=33437"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=33437"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}