cppclean

cppclean [options] paths...

cppclean finds problems in C++ source that slow development in large code bases, including various forms of unused code. It detects unnecessary #include directives in header files, unused forward declarations, functions declared but not defined, and classes with virtual methods but no virtual destructor.The tool identifies which headers can be safely removed, reducing compilation dependencies and speeding up incremental builds. It also detects inconsistent casing in #include paths (e.g., `foo.h` vs `Foo.h`) and global/static data that may cause problems with threads.

--include-path path

Additional include search path (like gcc -I). Can be specified multiple times. Not recursive.

Enable verbose output for debugging.

Suppress output messages.

May report false positives for conditionally compiled code (e.g., `#ifdef` blocks). Results should be verified before removing includes. Detection of unnecessary includes in source files (not headers) is limited.

clang-tidy(1), cppcheck(1), cpplint(1), gcc(1), cmake(1)