如何解决STM32CubeMX/CubeIDE项目移动或Git克隆后路径异常无法构建问题

CubeMX默认生成项目时，会将Drivers等依赖的头文件、源文件路径以绝对路径的形式写入CubeIDE的编译配置文件，项目目录移动或者跨设备克隆后，原绝对路径失效，就会出现Drivers下文件找不到的编译错误。

• 打开项目对应的.ioc配置文件，切换到「Project Manager」选项卡，在「Code Generator」子项中找到路径生成规则选项，勾选「Generate relative paths」，重新生成代码，从根源避免绝对路径写入编译配置。
• 若已导入CubeIDE后才发现问题，右键项目名称，选择「Properties」→「C/C++ General」→「Paths and Symbols」：
  • 切换到「Includes」标签页，删除所有带本地绝对路径的Drivers相关引用，替换为相对路径变量格式，例如${workspace_loc:/${ProjName}/Drivers/STM32F4xx_HAL_Driver/Inc}，需对应自己使用的MCU系列路径，同时要同步修改GCC、ASM两类编译规则下的头文件路径。
  • 切换到「Source Location」标签页，检查是否存在绝对路径的Drivers目录引用，同步替换为相对路径格式。
• 配置.gitignore规则，避免本地配置文件提交到Git仓库，文件中添加以下内容：

# CubeIDE 本地配置文件
/.settings/
/.project
/.cproject
*.launch
*.mxproject
# 编译输出目录
/Debug/
/Release/

• 跨设备克隆项目后的标准导入流程：新设备拉取代码后，选择「Import」→「General」→「Existing Projects into Workspace」，选择克隆后的项目根目录导入，不要直接打开旧的工作空间文件，导入后重新执行一次ioc的代码生成操作，再执行编译即可。

• 每次修改ioc文件重新生成代码后，建议检查一次编译配置的路径格式，部分旧版本CubeMX存在偶发改回绝对路径的问题，手动确认即可避免该问题复发。

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