如何让所有CLion项目自动引入同一个自定义头文件？

下面提供三种不同适配场景的实现方案，可根据自己的使用需求选择：

方案1：修改单文件模板（仅需自动添加头文件引入语句时使用） #

操作步骤：

• 打开CLion设置页：Windows/Linux 下走 File > Settings，macOS 下走 CLion > Settings
• 依次定位到 Editor > File and Code Templates 栏目
• 在Files分类下找到你需要修改的C++文件模板，常用的包括C++ Source File、C++ Header File
• 在模板编辑区的顶部加入你的头文件引入代码，比如你的自定义头文件命名为my_utils.hpp，就添加一行 #include "my_utils.hpp"
• 点击Apply保存配置即可，后续所有新建对应类型的C++文件都会自动带上该引入语句

提示：如果你的自定义头文件没有放在项目根目录，需要同步修改CMake配置添加头文件搜索路径，否则会触发编译报错。

方案2：创建自定义项目模板（需要复用整套项目配置时使用） #

如果除了头文件引入外，你还需要固定CMake规则、编译选项、预编译头设置等整套项目配置，可以直接保存自定义项目模板：

• 先新建一个空白项目，完成所有你需要的公共配置：
  • 将自定义头文件放到项目公共目录
  • 调整CMakeLists.txt，添加头文件搜索路径、常用编译选项、依赖配置等
  • 预先写好带公共头文件引入的main.cpp基础代码
• 所有配置完成后，点击菜单栏 File > Save Project as Template
• 填写模板名称、描述信息后确认保存
• 后续新建项目时，直接在新建项目的模板列表中选择你保存的自定义模板即可，所有配置会完整复用，无需重复修改。

方案3：全局预编译头引入（所有本地C++项目都需要用到该头文件时使用） #

如果你希望所有本地的C++项目都能直接调用自定义头文件的功能，不需要每个项目都复制头文件、手动写引入语句，可以配置全局强制引入：

• 将你的自定义头文件放到一个固定的全局目录，比如 Windows 下的C:\dev\cpp_common\、macOS/Linux 下的~/dev/cpp_common/
• 打开CLion设置，进入 Build, Execution, Deployment > CMake 栏目
• 在CMake options输入栏添加以下配置，将路径替换为你自己的头文件实际存放路径即可：

  # GCC/Clang 编译器用以下配置
  -DCMAKE_CXX_FLAGS="-include ~/dev/cpp_common/my_utils.hpp -I~/dev/cpp_common"
  
  # MSVC 编译器用以下配置
  -DCMAKE_CXX_FLAGS="/FI C:\dev\cpp_common\my_utils.hpp /I C:\dev\cpp_common"
  

• 保存配置后，所有新建的C++项目都会自动强制引入该头文件，无需手动写#include语句即可直接调用头文件中定义的所有功能。

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