{"id":25052,"date":"2019-10-08T18:34:42","date_gmt":"2019-10-08T18:34:42","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=25052"},"modified":"2019-11-06T23:48:03","modified_gmt":"2019-11-06T23:48:03","slug":"code-analysis-with-clang-tidy-in-visual-studio","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/code-analysis-with-clang-tidy-in-visual-studio\/","title":{"rendered":"Code analysis with clang-tidy in Visual Studio"},"content":{"rendered":"

[Updated on 11\/6\/2019]<\/strong> – Removed “Setup: Installing Clang tools” section; this is no longer required starting in Visual Studio 2019 version 16.4 Preview 3.<\/em><\/span><\/p>\n

Visual Studio 2019 version 16.4 Preview 1<\/a> brings a significant improvement to the C++ code analysis experience: native support for clang-tidy<\/a>, a Clang-based \u201clinter\u201d tool developed by the LLVM Project that delivers a variety of code improvements such as modernization and standards conformance, static analysis, and automatic formatting. For more information about using Clang\/LLVM as a compiler in your project, see our past blog posts on Clang\/LLVM for MSBuild projects<\/a> and for CMake projects<\/a>.<\/p>\n

Configuring clang-tidy<\/h2>\n

Code Analysis defaults to the respective tool as dictated by your platform toolset<\/a> and compiler: Microsoft Code Analysis if using MSVC (\u201cVisual Studio 2019\u201d) and clang-tidy if using LLVM\/clang-cl. While Code Analysis will run automatically in the background on files opened in the Editor, by default it will not run at build time on all your files. Read on to learn about further configuration options.<\/p>\n

MSBuild projects<\/h3>\n

We\u2019ve redesigned the Code Analysis section of project Property Pages, allowing you to better configure and define which tool you\u2019re using with each of your projects. In the General tab, you can select which tool(s) to run when running analysis \u2013 whether that\u2019s via the Analyze menu, on build, or automatically in the background<\/a>. (If you explicitly run Code Analysis without either tool enabled, you\u2019ll simply get a warning returned in the Error List.)<\/p>\n

\"\"<\/p>\n

Rule sets for the MSVC Code Analysis engine are configurable under the \u201cMicrosoft\u201d tab, while the \u201cClang-Tidy\u201d tab allows you to specify which specific clang-tidy checks to enable or disable, i.e. the input to be provided to the –checks<\/span>\u00a0 option of the tool.<\/p>\n

Further configuration is possible via .clang-tidy files, from where the tool attempts to read additional settings and in which you can provide further configuration, e.g. via options such as Checks, HeaderFilterRegex, and SystemHeaders. \u00a0See the LLVM.org documentation<\/a> for more details.<\/p>\n

CMake projects<\/h3>\n

In CMake configurations targeting Windows, you can customize checks by specifying the clangTidyChecks<\/span>\u00a0 key in the JSON view of CMakeSettings.json, with a string value to be passed to the tool\u2019s –checks<\/span>\u00a0 option like above. Starting in Preview 2, you can also configure which tool(s) to use via the enableMicrosoftCodeAnalysis<\/span> and enableClangTidyCodeAnalysis<\/span>\u00a0keys, with in-editor warnings and the Error List updating on file save.<\/p>\n

\"\"<\/p>\n

We do not currently support configuration via the CMAKE_<LANG>_CLANG_TIDY<\/span>\u00a0 variable in CMakeLists.txt in the IDE. In addition, Clang-Tidy support for CMake configurations only extends to Windows, i.e. we do not yet support WSL or remote Linux targeting.<\/p>\n

Code Analysis can be further configured (e.g. toggling squiggle display or background runs) within Tools > Options > Text Editor > C\/C++ > Advanced.<\/p>\n

Error List & editor integration<\/h2>\n

Running clang-tidy results in itemized warnings populating the Error List, from where you can quickly navigate around your code. The \u201cCategory\u201d column provides information on the type of warning based on the check prefix, e.g. cppcoreguidelines, readability, or clang-diagnostic.<\/p>\n

\"\"<\/p>\n

Warnings also display as in-editor squiggles so you can easily view the location and context of discovered issues. Squiggles show underneath relevant sections of code and hovering over these displays a tooltip with information about the issue, just like with Microsoft Code Analysis warnings.<\/p>\n

\"\"<\/p>\n

Future work<\/h2>\n

The UI doesn\u2019t currently support pointing Visual Studio to use a custom clang-tidy.exe<\/strong>, which may be desired in the case of using custom checks, but we\u2019re exploring this as an option going forward. We\u2019re also working toward allowing you to run clang-tidy with the –fix<\/span>\u00a0 flag<\/strong> and applying resulting quick fixes.<\/p>\n

Send us feedback<\/h2>\n

Your feedback is a key part of ensuring we\u2019re able to deliver the best Code Analysis experience to all! We\u2019d love for you to try out the latest Preview version of Visual Studio 2019 version 16.4<\/a> and let us know how it\u2019s working for you, either in the comments below or\u00a0via email<\/a>. If you encounter problems or have\u00a0suggestions,\u00a0please\u00a0Report A Problem<\/a> or reach out via Developer Community<\/a>. You can also find us on Twitter @VisualC<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

[Updated on 11\/6\/2019] – Removed “Setup: Installing Clang tools” section; this is no longer required starting in Visual Studio 2019 version 16.4 Preview 3. Visual Studio 2019 version 16.4 Preview 1 brings a significant improvement to the C++ code analysis experience: native support for clang-tidy, a Clang-based \u201clinter\u201d tool developed by the LLVM Project that […]<\/p>\n","protected":false},"author":1079,"featured_media":25058,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[270],"tags":[119],"class_list":["post-25052","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcement","tag-code-analysis"],"acf":[],"blog_post_summary":"

[Updated on 11\/6\/2019] – Removed “Setup: Installing Clang tools” section; this is no longer required starting in Visual Studio 2019 version 16.4 Preview 3. Visual Studio 2019 version 16.4 Preview 1 brings a significant improvement to the C++ code analysis experience: native support for clang-tidy, a Clang-based \u201clinter\u201d tool developed by the LLVM Project that […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/25052","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\/1079"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=25052"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/25052\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/25058"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=25052"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=25052"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=25052"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}