在进行SDK移植、驱动库添加或者工程目录整理的时候，开发人员经常会遇到“IAR头文件路径怎么添加，IAR头文件路径配置后仍然报错怎么办”这方面的问题；头文件路径表面上看着只是把文件夹放进去，然而在实际操作中，它还会受到工程配置、相对路径、宏定义、文件名大小写、条件编译以及源文件是否参与编译等多方面的影响。在IAR的编译选项里面，其实包含着预处理相关的配置，通常情况下，头文件的搜索路径就是在C/C++Compiler的Preprocessor配置项里进行维护的。

　　一、IAR头文件路径怎么添加

　　在添加头文件路径的时候，并不是把.h文件直接用鼠标拖进工程里面就算完成了；因为IAR需要明确知道编译器到底要去哪些目录里面查找include文件，所以用户真正需要配置的地方是“头文件所在的文件夹路径”。

　　1、进入预处理器配置

　　用户在打开工程之后，需要依次点击进入【Project】→【Options】→【C/C++Compiler】→【Preprocessor】，在这里找到Additional include directories对应的地方，然后把头文件所在的目录添加进去。

像常见的CMSIS目录、Device目录、Drivers目录、BSP目录以及Middlewares目录等，开发人员都可以根据工程的具体结构去逐个加入。

　　2、优先使用相对路径

　　因为工程在后续的操作中，可能会被复制到别人的电脑上、放进版本控制库里，或者换到一个新的工作目录；为了尽量减少路径失效的情况，建议大家优先去使用相对路径。它比直接去写C盘那样的绝对路径要稳妥得多；绝对路径往往在自己的电脑上能够正常编译，但是只要换一台电脑就会报错，这也是IAR工程在进行迁移时经常能碰到的典型问题。

　　3、区分C文件和头文件的作用

　　用户添加头文件路径，这件事情只能解决“找不到.h文件”的问题，并不能自动把.c文件也编译到工程里面去；举个例子，虽然系统已经能找到driver_uart.h了，但在链接的时候却依然报某个函数未定义，这时候用户就要去检查对应的driver_uart.c有没有被加入到工程里并参与编译。

　　二、IAR头文件路径配置后仍然报错怎么办

　　虽然路径已经加上去了，但是系统依然在报错，这时候常见的原因往往不是“路径没加进去”，反而是因为加错了配置、文件层级没有对齐、宏定义没有打开，或者说这个报错本身就不是头文件搜索引起的。

　　1、确认改的是当前配置

　　IAR工程通常都会区分Debug和Release这两种配置；用户可能只是在Debug模式里加了路径，但是当前正在编译的却是Release模式；又或者是只修改了其中一个工程目标，而另一个目标根本没有同步过去。用户需要进入【Project】→【Edit Configurations】或者去查看当前的活动配置，从而确认路径确实加在了正在编译的那个配置里面。

　　2、检查include写法和目录层级

　　代码里面的include写法，必须要和路径的层级一一对应起来。最麻烦的就是一部分文件写了完整的子目录，而另一部分文件却只写了文件名，后期在更换目录的时候就很容出现有的能找到、有的却找不到的情况。

　　3、检查宏定义和条件编译

　　有时候有些头文件报错并不是路径的问题，而是由于它被条件编译给挡住了；比方说芯片型号宏、板级宏、库版本宏这些没有被定义，从而导致代码走到了错误的分支里面，进而去包含了一些根本不存在的文件。IAR的预处理配置里面不仅有include目录，同时也有Defined symbols这类宏定义项，在进行工程移植的时候，这两者都是需要一起去核对的。

　　三、头文件相关报错还要怎么排查

　　头文件引起的报错，它们长得不一定都是完全一样的；有的是提示cannot open source file，有的是提示unknown type name，有的是宏未定义，还有的则是在链接阶段提示undefined symbol；不同的报错其实对应着不同的处理手段，大家不能一律都指望靠“加路径”来解决。

　　1、看清楚报错发生阶段

　　如果系统提示找不到.h文件，这多半是include路径、文件名或者目录层级出了问题；如果系统提示类型未定义，那有可能是头文件的包含顺序搞反了，或者是某个关键的宏没有被打开；如果系统提示函数未定义，这通常就已经不是头文件路径的事了，而是.c文件没有加入工程、库文件没有链接，或者是函数被条件编译给排除在外了。

　　2、注意文件名大小写和重复头文件

　　在Windows系统下面，文件名的大小写通常是不敏感的，但是如果把工程移到其他环境里、使用脚本去构建或者多人协作的时候，大小写不一致就会埋下隐患；比如代码里写的是：

　　#include"Uart.h"

　　但是实际的文件名却叫uart.h，这样在某些场景下就会冒出问题。

　　3、清理工程后重新编译

　　在把路径和宏都修改完毕之后，建议大家去执行一次【Project】→【Clean】，接着再点击【Rebuild All】。

因为一些旧的中间文件会让错误的表现变得不够直观，特别是在移动了目录、替换了SDK或者删除了旧头文件之后，重新进行一次完整的编译会更容易暴露出真实的问题。

　　总结

　　IAR头文件路径添加的核心配置位置，通常都是在【Project】→【Options】→【C/C++Compiler】→【Preprocessor】里面的Additional include directories。在进行配置的时候，用户要把头文件所在的文件夹给加进去，并且要尽量去使用相对路径，同时还要确认当前的Debug或Release配置已经真正生效了。在遇到IAR头文件路径配置后仍然报错的情况时，大家不要只是反复地去添加目录，而是要进一步去检查include的写法、目录的层级、源文件有没有参与编译以及报错发生的具体阶段。只要把这些因素分开来去客观看待，头文件这类的问题一般都是能够比较快地定位出来的。