include-what-you-use建议不存在的头文件，该如何排查？

核心原因：映射文件配置错误 #

__fwd/fstream.h是Clang/libc++的内部前置声明头文件，不属于标准库公开API，用户不应该直接包含。IWYU的核心功能之一是通过映射文件，将这类内部头文件关联到对应的公开标准头（比如<fstream>），但你的配置中指定了自定义的iwyu.imp文件：

• 要么该文件不存在，导致IWYU无法加载映射规则；
• 要么文件内容缺失libc++的标准映射，使得IWYU只能直接输出内部头文件路径。

解决步骤 #

1. 移除无效的自定义映射配置
   如果你没有专门维护自定义映射规则，直接删除CMakeLists中关于iwyu_options的配置，让IWYU使用默认的标准库映射。修改后的CMakeLists.txt：

   cmake_minimum_required(VERSION 3.5)
   project(MyTest VERSION 1.0 LANGUAGES CXX)
   add_executable(MyTest my_test.cpp)
   find_program(iwyu_path NAMES include-what-you-use iwyu OPTIONAL)
   if(iwyu_path)
       set_property(TARGET MyTest PROPERTY CXX_INCLUDE_WHAT_YOU_USE "${iwyu_path}")
   endif()
   

2. 若需自定义映射则补全规则
   如果确实需要自定义映射，确保iwyu.imp包含libc的正确映射规则。可以使用IWYU官方提供的默认libc映射文件作为基础，复制到项目目录后引用。

3. 验证版本兼容性
   确保IWYU版本与你当前使用的Clang版本匹配（macOS自带的Clang版本需要和IWYU编译时依赖的Clang版本一致），版本不匹配也可能导致映射规则失效。

额外说明 #

你的原始代码已经包含了正确的公开头文件<fstream>，这是std::ifstream的标准包含方式，正常情况下IWYU应该提示你无需修改，只有当映射规则失效时才会给出错误建议。

内容的提问来源于stack exchange，提问作者yairchu