如何在STM32CubeIDE中像Arduino IDE一样添加自定义全局库？

背景 #

在Arduino IDE中添加自定义库只需一次性操作（比如导入.zip包），之后任何新项目只要添加#include "lcdlib.h"就能直接调用库功能，无需额外配置。但STM32CubeIDE默认没有这种全局库机制，当前每次新建项目都得做以下繁琐操作之一：

• 手动把库的.h头文件复制到项目Core/Inc目录，.c源文件复制到Core/Src目录
• 使用「Linked Folder」方式，但仍需逐个项目手动配置：进入Properties → C/C++ General → Paths and Symbols → Includes添加头文件路径，还要设置源文件链接让编译器能找到.c文件

当需要在多个STM32项目复用同一自定义库时，重复操作效率极低，因此需要配置全局库目录，实现新项目仅需#include "mylib.h"即可自动识别路径并编译关联源文件。

具体配置步骤 #

1. 准备全局库目录

先把自定义库整理成固定的清晰结构，示例如下：

D:/STM32_Global_Libs/
└── mylib/
    ├── Inc/
    │   └── mylib.h
    └── Src/
        └── mylib.c

确保头文件和源文件分别放在Inc和Src子目录下。

2. 配置全局头文件包含路径

• 打开STM32CubeIDE，点击顶部菜单栏Window → Preferences
• 在弹窗中展开C/C++ → Build → Settings，切换到Tool Settings标签页
• 展开MCU GCC Compiler → Includes，点击右侧Add...按钮
• 在弹出窗口选择File system，定位到库的头文件目录（如D:/STM32_Global_Libs/mylib/Inc），勾选Add to all configurations后点击OK保存

3. 配置全局源文件自动编译

这一步是实现自动编译的核心，需要通过自定义项目模板完成：

• 继续在Preferences中，展开C/C++ → New Project Wizard → Templates
• 找到STM32CubeIDE默认的STM32CubeProject模板，右键选择Copy创建自定义模板
• 编辑该自定义模板：找到模板对应的编译配置文件（CMakeLists.txt或Makefile，通常在模板的Core目录相关配置中）
  • 若用CMakeLists.txt，在add_executable块中添加全局库源文件路径：

    add_executable(${PROJECT_NAME}
      # 原有项目源文件...
      D:/STM32_Global_Libs/mylib/Src/mylib.c
    )
    

  • 若用Makefile，在SRC变量中添加源文件路径
• 保存自定义模板，后续新建项目时选择该模板而非默认模板

4. 验证配置

• 使用自定义模板新建STM32项目
• 在main.c中添加#include "mylib.h"，IDE不会报头文件找不到的错误
• 编译项目，编译器会自动编译全局库的mylib.c文件，无需额外操作

补充说明 #

• 若库包含多个源文件，可在模板配置中批量添加路径，或使用通配符（如D:/STM32_Global_Libs/mylib/Src/*.c，注意CMake和Makefile对通配符的支持略有差异）
• 后续更新全局库文件后，所有使用该模板创建的项目会自动调用最新版本，无需逐个项目更新

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