{"id":32556,"date":"2023-07-11T17:00:13","date_gmt":"2023-07-11T17:00:13","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=32556"},"modified":"2023-11-20T21:46:11","modified_gmt":"2023-11-20T21:46:11","slug":"include-cleanup-in-visual-studio","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/include-cleanup-in-visual-studio\/","title":{"rendered":"#include cleanup in Visual Studio"},"content":{"rendered":"

We are gradually rolling out this feature in Visual Studio 2022 version 17.8 to monitor some data. This means that not everyone will have access to the feature immediately after its release.<\/span><\/em><\/div><\/p>\n

We are thrilled to announce the return of <\/span>#<\/span>include<\/span> c<\/span>leanup<\/span>, a <\/span>tool that helps you <\/span>maintain<\/span> clean code, now available in Visual Studio 17.8 Preview 1<\/span>.<\/span> To start using <\/span>this<\/span> feature<\/span>, make sure to update to the latest version of Visual Studio Preview.<\/span><\/span>\u202f<\/span><\/span><\/p>\n

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

#include cleanup<\/span><\/span>\u202f<\/span><\/span>\u00a0<\/span><\/h3>\n

Visual Studio now offers #include cleanup, a feature that improves the quality of your code by generating suggestions to remove unused headers and add direct headers. Our suggested workflow is to first go through the direct include suggestions to add direct headers where indirect headers are used, followed by removing the unused includes.<\/p>\n

Remove unused <\/span><\/span><\/span><\/span>#include statements<\/span><\/span><\/span><\/span>\u00a0<\/span><\/h4>\n

This feature provides suggestions to remove unused headers from your files, enhancing code cleanliness. When an unused include is detected, it is visually dimmed by default. By hovering over the dimmed include, a quick action (indicated by three dots in the default view) prompt will appear, notifying you about the unused include in the file. You can click on the light bulb to remove the unused include or all unused includes. This makes it easier to clean up your code and ensures that you keep only the necessary includes to keep your code well-organized.<\/p>\n

\"Gif<\/a>
Gif showing remove unused includes.<\/figcaption><\/figure><\/p>\n

Add <\/span><\/span><\/span><\/span>transitively used #include statements<\/span><\/span><\/span><\/span>\u00a0<\/span><\/h4>\n

In Visual Studio, there is an existing feature that alerts users when an include is used but not added to the file. This is indicated by a squiggle and suggests adding the required include. Currently, we have added a new feature that provides suggestions for adding direct includes when your file has indirect dependencies. Including indirect dependencies can result in longer compilation times. However, with the help of direct include suggestions, you can optimize compilation time by including only the essential direct dependencies.<\/p>\n

In instances where the direct include for certain content is missing, a quick action (<\/span>indicated<\/span> by three dots in the default view)<\/span> will appear. Hovering over it will inform you that content from that transitive include is being used. Then, you have the <\/span>option<\/span> to either <\/span>add the direct include individually<\/span> or <\/span>add<\/span> all transitively used <\/span>includes<\/span><\/span>. By choosing to include all transitively used includes, all the <\/span><\/span><\/span>direct headers will be automatically added wherever indirect headers are used in the file.<\/span><\/span><\/span> After including the direct dependencies, it is crucial to remove any unused includes, retaining only those that are necessary.<\/p>\n

\"Gif<\/a>
Gif showing add direct include suggestion.<\/figcaption><\/figure><\/p>\n

To quickly perform code cleanup, you can configure code cleanup by adding \u201cAdd transitively used and remove unused #include statements (C++)\u201d. Once this setup is complete, you’ll have the convenience of adding all transitively used includes and removing all unused includes with just a single click on the broom icon. This streamlines the process and ensures that your code remains clean.<\/p>\n

\"Gif<\/a>
Gif displaying Configure Code Cleanup.<\/figcaption><\/figure><\/p>\n

By default, #include cleanup is disabled, but you can enable it by navigating to Tools > Options > Text Editor > C\/C++ > IntelliSense and selecting “Enable #include cleanup.” Once enabled, you have the flexibility to adjust the settings and configure different levels to meet your specific needs and preferences.<\/p>\n

\"Image<\/a>
Image displaying code cleanup setting.<\/figcaption><\/figure><\/p>\n

Customization Options<\/h3>\n

You have the flexibility to customize how the #include cleanup generates suggestions, allowing it to seamlessly adapt and integrate with intricate and extensive codebases. By making these changes or adjustments, you can ensure that the process better aligns with the specific needs and complexities of your project, resulting in a more efficient and effective code cleanup. In the EditorConfig (EditorConfig settings<\/span><\/span><\/a>), you can add a single header, and if you want to include multiple headers, you should separate them using commas.<\/p>\n

Exclude Files<\/span><\/span>\u00a0<\/span><\/h5>\n

To exclude specific includes from #include cleanup suggestions, you can utilize EditorConfig. This allows you to categorize and define which files should not be considered for suggestions, providing greater control over the suggestions generated by #include cleanup.\nExamples of excluding single and multiple files (exclude vcruntime.h<\/code> and vcruntime_string.h<\/code> from cleanup suggestions):<\/p>\n

cpp_include_cleanup_excluded_files = vcruntime.h<\/code><\/pre>\n
cpp_include_cleanup_excluded_files = vcruntime.h,vcruntime_string.h<\/code><\/pre>\n
Required Files<\/h5>\n
In cases where headers require other headers, and you don’t want suggestions generated, you can specify the dependencies in the EditorConfig. This ensures that required files won’t be marked as unused.\nExamples of single and multiple required files (atlwin.h<\/code> requires altbase.h<\/code> and atlcom.h<\/code> requires altbase.h<\/code>):<\/p>\n
cpp_include_cleanup_required_files = atlwin.h:altbase.h<\/code><\/pre>\n
cpp_include_cleanup_required_files = atlwin.h:altbase.h,atlcom.h:altbase.h<\/code><\/pre>\n
Files Replacement<\/span><\/span><\/h5>\n
This feature also supports the remapping of facade headers. If a file is intended to represent a different file, you can redirect the usage of the first file to the usage of the second file in EditorConfig.\nExamples of single and multiple replaced files (replace stdio.h<\/code> by cstdio<\/code>, and replace stdint.h<\/code> by cstdint<\/code>):<\/p>\n
cpp_include_cleanup_replacement_files = stdio.h:cstdio<\/code><\/pre>\n
cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint<\/code><\/pre>\n
Alternate Files<\/span><\/span>\u202f<\/span><\/span>\u00a0<\/span><\/h5>\n
In certain situations, you may have alternative options for including a file, such as facade files. When the usage of one file can be considered as an alternative to the usage of another file, you can specify this relationship in EditorConfig. By doing so, you can prevent #include cleanup from generating suggestions for alternate matches.\nExamples of single and multiple alternate files (windows.h<\/code> is an alternate for minwindef.h<\/code> and windows.h<\/code> is an alternate for winerror.h<\/code>):<\/p>\n
cpp_include_cleanup_alternate_files = windows.h:minwindef.h<\/code><\/pre>\n
cpp_include_cleanup_alternate_files = windows.h:minwindef.h,windows.h:winerror.h<\/code><\/pre>\n
Send us your feedback!<\/span><\/span>\u202f<\/span><\/span>\u00a0<\/span><\/h3>\n
Explore <\/span>#<\/span>Include Cleanup by downloading the <\/span><\/span>latest version of Visual Studio Preview<\/span><\/span><\/a>.<\/span> We genuinely value your feedback as it plays a crucial role in shaping our development process. <\/span>Please share your thoughts in the comments below, on <\/span><\/span>Developer Community<\/span><\/span><\/a>, or reach out to us on Twitter\u202f(<\/span><\/span>@VisualC<\/span><\/span><\/a>) or via email at <\/span><\/span>visualcpp@microsoft.com<\/span><\/span><\/a>. Your input is highly appreciated!<\/span><\/span>\u202f<\/span><\/span>\u00a0<\/span><\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
We are thrilled to announce the return of #include cleanup, a tool that helps you maintain clean code, now available in Visual Studio 17.8 Preview 1. To start using this feature, make sure to update to the latest version of Visual Studio Preview.\u202f #include cleanup\u202f\u00a0 Visual Studio now offers #include cleanup, a feature that improves […]<\/p>\n","protected":false},"author":96741,"featured_media":35994,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,3927],"tags":[],"class_list":["post-32556","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus","category-game-development"],"acf":[],"blog_post_summary":"
We are thrilled to announce the return of #include cleanup, a tool that helps you maintain clean code, now available in Visual Studio 17.8 Preview 1. To start using this feature, make sure to update to the latest version of Visual Studio Preview.\u202f #include cleanup\u202f\u00a0 Visual Studio now offers #include cleanup, a feature that improves […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/32556","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=32556"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/32556\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/35994"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=32556"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=32556"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=32556"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}