{"id":24706,"date":"2019-07-24T23:00:08","date_gmt":"2019-07-24T23:00:08","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=24706"},"modified":"2019-07-24T23:28:36","modified_gmt":"2019-07-24T23:28:36","slug":"visual-studio-code-c-c-extension-july-2019-update","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/visual-studio-code-c-c-extension-july-2019-update\/","title":{"rendered":"Visual Studio Code C\/C++ Extension: July 2019 Update"},"content":{"rendered":"

The July 2019 update of the Visual Studio Code C\/C++ extension<\/a> is now available. This release includes many new features, including semantic colorization and improvements to the IntelliSense Configuration Settings Editor UI and IntelliSense cache. For a full list of this release\u2019s improvements, check out our release notes on GitHub<\/a>.<\/p>\n

Semantic Colorization<\/h2>\n

Semantic colorization support has been one of the top asks on our GitHub repo for the past few years. We faced many challenges in creating support for semantic colorization for the C\/C++ extension since there is no VS Code API for semantic source highlighting<\/a> and no support for semantic colorization<\/a> in the VS Code language server protocol<\/a>. We also can\u2019t access a theme\u2019s colors programmatically<\/a>, so this support was even more challenging to make possible. Luckily, we were able to devise a way to overcome these challenges by managing our own set of tokens and their ranges, using TextEditorDecorations<\/a>, and directly parsing theme files and VS Code settings to determine which colors to apply. With that, we are excited to share semantic colorization support!<\/p>\n

\"GitHub<\/p>\n

Semantic colorization support provides colorization to tokens even when they are out of context, thus providing colorization beyond that of syntax. For example, if you use a variable name outside of the place in which the variable is declared, you will see colorization:<\/p>\n

\"Box<\/p>\n

In the above example, we see our struct is now colorized when it is defined as \u2018box\u2019 and<\/em> when it is used in our main function.<\/p>\n

Themes<\/h3>\n

The colors can be mapped using the existing support for theming and color customization in VS Code. Documentation on Theming in VS Code can be found\u00a0here<\/a>. Colors are associated with\u00a0TextMate scopes<\/a>. You can read more about the C\/C++ extension IntelliSense tokens and scopes in our colorization documentation<\/a>.<\/p>\n

Many of the tokens recognized by IntelliSense do not directly map to existing scopes in VS Code’s default C\/C++ TextMate grammar, so those will not be colored by existing VS Code themes. You can customize your color settings in Visual Studio Code, however. There are two ways in which you can do this \u2013 via global settings or on a per-theme basis. Theme authors can also make use of these scopes when creating a new color theme<\/a>.<\/p>\n

Customize Colors in Global Setting<\/h4>\n

In your settings.json file you can customize the colors for all themes by overriding the tokenColorCustomizations setting:<\/p>\n

    \"editor.tokenColorCustomizations\": {\r\n        \"textMateRules\": [\r\n            {\r\n                \"scope\": \"entity.name.type\",\r\n                \"settings\": {\r\n                    \"foreground\": \"#FF0000\",\r\n                    \"fontStyle\": \"italic bold underline\"\r\n                }\r\n            }\r\n        ]\r\n    }<\/pre>\n
Customize Colors for a Theme<\/h4>\n
You can also customize colors on a per-theme basis. In this example, we override the Visual Studio Dark theme settings:<\/p>\n
\"editor.tokenColorCustomizations\": {\r\n        \"[Visual Studio Dark]\": {\r\n            \"textMateRules\": [\r\n                {\r\n                    \"scope\": \"entity.name.type\",\r\n                    \"settings\": {\r\n                        \"foreground\": \"#FF0000\",\r\n                        \"fontStyle\": \"italic bold underline\"\r\n                    }\r\n                }\r\n            ]    \r\n        }<\/pre>\n
 <\/p>\n
We created templates to customize Visual Studio Dark and Visual Studio Light themes<\/a> in our documentation for easier colorization customization.<\/p>\n
IntelliSense Configuration settings editor UI<\/h2>\n
The goal of the settings editor UI is to provide an alternative interface to the c_cpp_properties.json file for configuring IntelliSense for the C\/C++ extension. The interface is simple and clear, and thus makes IntelliSense configuration easier to understand. Based on your feedback, we made a few improvements to the IntelliSense Configuration settings editor UI.<\/p>\n
Select, Edit, and Add Configurations<\/h3>\n
There are a variety of reasons you may benefit from multiple IntelliSense configurations. For example, you may be using debug and release builds. In this case, having IntelliSense configured for debugging and release can improve your editing experience when switching between build types. To more easily get started with multiple configurations, we added an option to select the configuration you\u2019d like to work with:<\/p>\n
\"Select<\/p>\n
Further, you can edit the settings of the selected configuration:<\/p>\n
\"Edit<\/p>\n
Finally, you can add configurations via the settings editor UI:<\/p>\n
\"Add<\/p>\n
\"select<\/p>\n
List of Detected Compiler Paths<\/h3>\n
You can also now see a list of detected compiler paths in the UI under the \u201ccompiler path\u201d dropdown text field.<\/p>\n
\"Select<\/p>\n
We hope these improvements to the IntelliSense Configuration settings editor UI will help you more easily configure IntelliSense with the C\/C++ extension.<\/p>\n
IntelliSense Cache<\/h2>\n
We introduced IntelliSense Caching in the C\/C++ extension March 2019 update<\/a>. The purpose of it is to cache header information to improve IntelliSense speed. We received a lot of feedback on the default size for IntelliSense caching via an issue filed in our GitHub repo<\/a>. After a productive conversation, we devised a proposal for changes to the default path. We have improved this feature in the July 2019 update.<\/p>\n
The Default Path<\/h3>\n
Previously, the default path for the IntelliSense cache was in the \u201c.vscode\u201d folder of the project workspace (${workspaceFolder}\/.vscode). Changing the default path enables us to address concerns of the cache on source control for the workspace folder. Furthermore, since the cache size limit is applied to a cache location, having one location reduces the overall disk space usage of the cache.<\/p>\n
Now, the default for the C_Cpp.intelliSenseCachePath setting is \u201c~\/.vscode-cpptools\u201d on Linux and macOS and \u201c%LocalAppData%\/Microsoft\/vscode-cpptools\u201d on Windows.<\/p>\n
Note, the extension will automatically remove any caches previously added to the ${workspaceFolder}\/.vscode folder if you were using the old IntelliSense cache path default.<\/p>\n
Tell Us What You Think<\/h2>\n
Download the C\/C++ extension for Visual Studio Code<\/a>, give it a try, and let us know what you think. If you run into any issues, or have any suggestions, please report them on the Issues section of our GitHub repository<\/a>. Set the C_CppProperties.UpdateChannel in your Visual Studio Code settings to \u201cInsiders\u201d to get early builds of our extension.<\/p>\n
We can be reached via the comments below or via email (visualcpp@microsoft.com). You can also find our team \u2013 and me \u2013 on Twitter (@VisualC<\/a> or @tara_msft<\/a>).<\/p>\n","protected":false},"excerpt":{"rendered":"
The July 2019 update of the Visual Studio Code C\/C++ extension is now available. This release includes many new features, including semantic colorization and improvements to the IntelliSense Configuration Settings Editor UI and IntelliSense cache. For a full list of this release\u2019s improvements, check out our release notes on GitHub. Semantic Colorization Semantic colorization support […]<\/p>\n","protected":false},"author":1305,"featured_media":24709,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,230,275],"tags":[8,140,2342,2343,14,284,2261,66,276],"class_list":["post-24706","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus","category-new-feature","category-visual-studio-code","tag-announcement","tag-c","tag-colorization","tag-configuration","tag-intellisense","tag-linux","tag-macos","tag-performance","tag-vscode"],"acf":[],"blog_post_summary":"
The July 2019 update of the Visual Studio Code C\/C++ extension is now available. This release includes many new features, including semantic colorization and improvements to the IntelliSense Configuration Settings Editor UI and IntelliSense cache. For a full list of this release\u2019s improvements, check out our release notes on GitHub. Semantic Colorization Semantic colorization support […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/24706","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\/1305"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=24706"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/24706\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/24709"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=24706"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=24706"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=24706"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}