Customizing default settings

The following C_Cpp.default.* settings map to each of the properties in a configuration block of c_cpp_properties.json. Namely:

These settings have all of the benefits of VS Code settings, meaning that they can have default, “User”, “Workspace”, and “Folder” values. So you can set a global value for C_Cpp.default.cppStandard in your “User” settings and have it apply to all of the folders you open. If any one folder needs a different value, you can override the value by adding a “Folder” or “Workspace” value.

This property of VS Code settings allows you to configure each of your workspaces independently - making the c_cpp_properties.json file optional.

Updated c_cpp_properties.json syntax

A special variable has been added to the accepted syntax of c_cpp_properties.json that will instruct the extension to insert the value from the VS Code settings mentioned above. If you set the value of any setting in c_cpp_properties.json to “${default}” it will instruct the extension to read the VS Code default setting for that property and insert it. For example:

If a property is missing from c_cpp_properties.json, the extension will use the value in the VS Code setting. If a developer assigns values to all of the settings that apply for a given folder, then could be removed from the .vscode folder as it will no longer be needed.

For in-depth information about the c_cpp_properties.json settings file, See .

A new setting will be added that allows you specify the system include path separate from the folder’s include path. If this setting has a value, then the system include path the extension gets from the compiler specified in the compilerPath setting will not be added to the path array that the extension uses for IntelliSense. We may want to provide a VS Code command to populate this value from the compiler’s default for users who are interested in using it in case they want to make some modifications to the defaults.

The extension determines the system includePath and defines to send to the IntelliSense engine in the following manner:

1. • The system include path and defines are determined using the following logic (in order):
     1. If systemIncludePath has a value, use it (continue to the next step to search for system defines).
     2. If compilerPath is valid, query it.
     3. Interpret the first argument in the command as the compiler and attempt to query it.
     4. If compilerPath is undefined, look for a compiler on the system and query it.

2. If compileCommands is invalid or the current file is not listed in the database, use the includePath and properties in the configuration for IntelliSense.

   • The system include path and defines are determined using the following logic (in order):
     1. If systemIncludePath has a value, use it (continue to the next step to search for system defines).
     2. If compilerPath is valid, query it.
     3. If compilerPath is undefined, look for a compiler on the system and query it.

System includes should not be added to the includePath or browse.path variables. If the extension detects any system include paths in the property it will silently remove them so that it can ensure system include paths are added last and in the correct order (this is especially important for GCC/Clang).

When IntelliSense is enabled, the Visual Studio Code C/C++ extension supports semantic colorization. See Enhanced colorization for more details about setting colors for classes, functions, variables and so on.

If you are experiencing a problem with the extension that we can’t diagnose based on information in your issue report, we might ask you to enable logging and send us your logs. See for information about how to collect logs.