先用 include-what-you-use test.cpp -std=c++17 验证基础功能，再通过 CMake 集成或 compile_commands.json 确保路径与宏正确；它能精准识别隐式依赖并建议显式包含，避免脆弱间接引用。
直接用 include-what-you-use 扫描并按建议修改，别手动删——它能区分“没用但被间接依赖”的头文件，手动删大概率编译失败。
怎么跑通第一个 include-what-you-use 命令
先确认你有匹配的 Clang 和 IWYU 版本（比如 Clang 14 对应 clang_14 分支），然后确保 include-what-you-use 可执行：
- 最简命令：
include-what-you-use test.cpp -std=c++17，它会输出建议：哪些头文件该删、哪些该加、哪些该换成前置声明 - 如果项目用 CMake，更推荐在构建时集成：
set_property(TARGET my_target PROPERTY CXX_INCLUDE_WHAT_YOU_USE /path/to/include-what-you-use)，这样能复用项目的 include 路径和宏定义 - 常见报错
error: unable to handle compilation, expected exactly one compiler job，说明 IWYU 没拿到完整的编译命令——用compile_commands.json更稳：include-what-you-use -p build/ test.cpp
为什么 #include <vector> 明明没用却被建议保留
不是 IWYU 错了，而是它检测到了隐式依赖。比如你写了 std::vector<int> v; 却没 #include <vector>，但某个已包含的头文件（如 boost/container/vector.hpp）内部又包含了 <vector>，这时 IWYU 会指出：“你依赖了 <vector> 的定义，但没显式包含它——这是脆弱的间接依赖”。
Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.
下载
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 它建议保留，是在帮你把隐式依赖显性化，避免某天那个 boost 头文件改版后删掉
<vector>包含，你的代码就崩了 - 真正该删的是那种：头文件里完全没出现任何来自该头的符号，连模板实例化、typedef、using 都没有
- 注意
std::string这类常用类型，有时<string>是通过<iostream>间接拉进来的——IWYU 会明确告诉你“remove <iostream>, add <string>”
CI 里自动检查头文件冗余的关键配置
光本地跑一次没用，得让 IWYU 成为编译流程的一部分，否则新人一提交就倒退。
- 生成
compile_commands.json是前提：CMake 加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON，或 Ninja/Bazel 输出对应格式 - 用
--check_also参数让 IWYU 返回非零退出码（有建议即失败）：include-what-you-use -p build/ --check_also src/*.cpp - 过滤误报：有些头文件是构建系统强制注入的（如
config.h），用--mapping_file写规则跳过：{"regex": "config\.h", "replace": ""} - 别让它卡住 CI：加
--no_comments关闭中文注释，避免终端编码问题；加--output_format=xml方便解析结果
最常被忽略的一点：IWYU 不处理宏展开后的包含（比如 #define INCLUDE_VEC <vector>），也不分析预编译头（stdafx.h 或 module.pch）。这些地方得靠人工 review 或其他工具补位。
