在STM32CUBEIDE中配置STM32F103C4完以后直接编译出现《没有 “huart2() at 0x20000108” 对应的源文件》不知道该如何把huart导入到编译器的路径下

你这个问题本质上是 “链接器找不到 huart2 这个符号的定义” ，而不是“没把文件放进路径”。 STM32CubeIDE 里，外设句柄（UART_HandleTypeDef huart2）是由 CubeMX 自动生成 的，只要你在 .ioc 里勾选了 USART2 ，代码就会生成在 usart.c 里，并声明在 usart.h 中。 编译器报错“no source file for huart2() at 0x20000108”通常并不是真的缺源文件，而是 链接器发现 huart2 这个符号根本不存在 ，于是把它当成一个“外部符号”去找，结果找不到，就给出一条让人误解的提示。

---

一、先快速自检（30 秒搞定）

1. 双击 .ioc → Pinout & Configuration → Connectivity → 确认 USART2 的 Mode 不是 Disable 。
2. 右侧 “Project Manager” → Code Generator → 勾选 “Generate peripheral initialization as a pair of .c/.h files” 。
3. 保存 .ioc，点 “Generate Code” 。
4. 重新编译（Project → Build All）。

如果错误消失，问题就解决了；如果还在，继续往下看。

---

二、如果 USART2 已勾选仍然报错

99 % 的情况是你 手动改动了代码 ，把 CubeMX 生成的定义删掉了，或者条件编译被关掉了。

1. 打开 usart.c（CubeMX 生成，路径在 Core/Src/usart.c），搜索 c复制

   UART_HandleTypeDef huart2;

   如果搜不到，说明定义确实被弄丢了。

2. 打开 usart.h，确认有 c复制

   extern UART_HandleTypeDef huart2;

3. 确认没有任何 c复制

   #ifdef USE_USART2

   之类的宏把定义包起来，而你的工程里又没开这个宏。

---

三、最干净的恢复办法

如果文件被改得乱七八糟，直接让 CubeMX 重新生成最省心：

1. 在 Project Explorer 里把 Core/Src/usart.c 和 Core/Inc/usart.h 删除（或者重命名备份）。
2. 回到 .ioc，随便改一个参数（比如 USART2 的波特率改 115400 → 115200），保存，重新 Generate Code。
3. CubeMX 会重新创建 usart.c/h，里面一定带 huart2。
4. 重新编译，0 Error。

四、总结一句话

“huart2 找不到” 不是路径问题，而是 huart2 这个全局变量根本没被定义。 让 CubeMX 重新生成 usart.c/h 是最快、最不容易出错的做法。

估计是工程没建完整，最好使用STM32CubeMx配置后创建工程，这样也省事。

不然的话，你就得自行做些确认，该定义的是否定义、该添加的是否添加、该包

含的是否包含。

我刚才使用Cubemx配置后快速创建了基于STM32F103C4的STM32CubeIDE的工程，启用了

UART2,编译无误。

fafa1 发表于 2025-11-28 11:29
你这个问题本质上是 <strong>“链接器找不到 <code>huart2</code> 这个符号的定义”</strong> ，而不是“没把文件放进路径”。
S ...

[md]依据您提示的三种办法，我将之前项目删除，然后重新新建了一个项目，在ioc中配置完成后，我没有更改任何CUBEIDE生成的代码，编译时一切正常，但是运行时依旧出现《没有 “huart2() at 0x20000108” 对应的源文件》，我以按照方法1快速自检，按照方法二检查.c以及.h文件，我不知道是否还需要使用#ifdef USE_USART2以及该放在何处，十分感谢您的回答。