CMake Tools for Visual Studio Code documentation
April 25, 2025 ยท View on GitHub
CMake Tools is an extension designed to make it easy to work with CMake-based projects.
If you are new, try the CMake Tools quick start and see the frequently asked questions.
- Create a new project
- Configure a project
- Build a project
- Debug a project
- Pass command-line arguments to the debugger
- Set up include paths for C++ IntelliSense
- Configure and build with CMake Presets
- Supported CMake and CMakePresets.json versions
- Enable CMakePresets.json in the CMake Tools extension
- Configure and build
- CMake: Configure
- CMake: Select Build Preset
- CMake: Build
- Test
- CMake: Select Test Preset
- CMake: Run Tests
- Add new presets
- Add new Configure Presets
- Add new Build Presets
- Edit presets
- Select your generator
- Set and reference environment variables
- Vcpkg integration
- Command substitution in launch.json and settings.json
- Ignored settings
- Unsupported commands
- Troubleshooting
- Run CMake from the command line or a Continuous Integration (CI) pipeline
- Sourcing the environment when building with command line generators on Windows
- Example CMakePresets.json file
- CMake configuration process overview
- The CMake tools configure step
- The configure step outside of CMake Tools
- Clean configure
- Select a launch target
- Quick debugging
- Debug using a launch.json file
- Run without debugging
- Debugging CMake
Configure CMake Tools settings
- Variant YAML example
- Variant schema
- Variant settings
- Variant options
- How variants are applied
- Large variant file example
- Common issues and resolutions
- CMake Tools is unable to provide IntelliSense configuration
- Green squiggles beneath #include directives
- Debugging ignores launch.json
- Reset CMake Tools extension state
- Increase the logging level
- Check the log file
- Get help