C语言#include风格规范争议：CLion自动导入为何与常规规则相悖？

• 行业通用约定是：系统头文件用 <foo.h> 格式，自定义头文件用 "bar.h" 格式。背后逻辑是 <> 直接从系统指定的包含路径自上而下查找，"" 则优先查找当前源文件所在的本地目录，再走系统路径。

• 你遇到的CLion自动导入用 <bar.h> 的情况，本质是因为通过CMake把自定义头文件目录设成了项目包含目录。CLion会把这类目录识别为「全局级包含路径」，和系统头文件路径地位等价，所以自动导入时套用 <> 格式。

• 这种逻辑其实合理：

  • 编译层面：当自定义头目录被加入CMake的包含目录后，编译器处理 <bar.h> 和 "bar.h" 的查找结果完全一致——都会优先去你指定的目录找，不存在性能或顺序上的差异。
  • 维护层面：用 <> 标记全局可用的自定义头文件，和用 "bar.h" 标记模块私有头文件形成区分，能让项目结构更清晰，其他开发者一眼就能分清头文件的作用范围。

• 如果你更想遵循传统风格约定，完全可以手动把自动生成的 <bar.h> 改成 "bar.h"，CLion不会限制。另外也可以尝试在CMake里把自定义头目录设为 PRIVATE 属性，部分版本的CLion会据此调整自动导入的格式。

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