报错stm32f7xx_hal.h: No such file or directory

发表于 2026-2-25 17:06

我在生成代码后遇到了报错问题，具体错误提示为：
stm32f7xx_hal.h: No such file or directory
这个文件实际存在于路径 Drivers/STM32F7xx_HAL_Driver/Inc 下，我也检查了项目的包含路径，确认该路径已被添加。当我按住 Ctrl 键点击某文件中的 #include "stm32f7xx_hal.h" 语句时，IDE 能正常跳转到该文件的正确位置，但报错依然存在。且该错误仅在代码生成后出现。
我当前的项目用到了 FREERTOS 和 USART3 。

发表于 2026-2-26 16:50

检查Drivers/STM32F7xx_HAL_Driver/Inc是否是相对于项目根目录的正确相对路径。如果使用绝对路径，路径需无空格或特殊字符。

发表于 2026-2-26 17:50

如果头文件引用为 #include "stm32f7xx_hal.h"，该路径应在编译器的引号包含路径

发表于 2026-2-26 16:51

清理重建项目

发表于 2026-2-26 18:52

FreeRTOS 可能修改了默认的包含路径。检查 FreeRTOSConfig.h 或项目中的 include_directories 是否覆盖了 HAL 路径。

发表于 2026-2-26 19:52

如果 USART3 初始化代码中引用了 HAL 头文件，但未正确链接 HAL 库，可能导致间接报错。检查 MX_USART3_UART_Init() 函数的生成代码是否完整。

发表于 2026-2-26 20:53

看下stm32f7xx_hal.h 文件是否被损坏

发表于 2026-2-26 22:54

用的 CubeIDE 版本与 STM32F7 的 HAL 库版本可能不匹配。

发表于 2026-2-26 21:54

可能是环境安装问题，重装 CubeIDE。

发表于 2026-2-26 17:25

检查包含路径配置有无拼写错误或路径覆盖问题

发表于 2026-2-26 19:26

更新或重装开发环境

[STM32F7] 报错stm32f7xx_hal.h: No such file or directory

相关帖子

浏览过的版块