把工程从一台电脑搬到另一台，即便源代码一个文件都没缺，重新编译的时候却频频碰到头文件找不到、链接不通过、脚本运行出错或者调试器压根打不开，这类现象在实际开发里挺常见的；要弄明白IAR工程迁到新电脑后为什么编译会失败，以及迁移过程中哪些配置最容易被漏掉，很多时候并不是代码突然出了毛病，而是新电脑上没有配齐原本环境里那些工具链组件、路径变量、链接文件或者前后执行的步骤。IAR Embedded Workbench这个软件本身就包含了编译器、汇编器、链接器、库管理工具和调试器，如果迁移时只把源码的文件夹拷贝过去，一般是远远不够用的。

　　一、IAR工程迁移到新电脑后为什么编不过

　　工程迁移失败以后，先去看一看编译窗口里最上面的那一条错误，不要急着去改动源代码，因为排在最前面的报错通常离真实的原因更近一些。

　　1、IAR自身的版本或者芯片支持包对不上

　　新旧两台电脑上安装的IAR版本可能并不一样，这就会让芯片支持包、运行库和一些默认的配置也出现差别；可以先打开【Help】→【Product Info】核对一下产品版本以及共享组件的版本，IAR官方的文档也说过，不同的工具链各自对应着不同的微控制器支持范围，只有这一项先对上，后面再往下排查才有意义。

　　2、头文件的查找路径还是指向原来的电脑

　　接着要到【Project】→【Options】→【C/C++Compiler】→【Preprocessor】里面，去确认额外包含的那些目录，这里最常见的问题是路径还写成旧电脑的盘符，或者直接引用了那些没有随项目一起拷过来的SDK目录；其实IAR允许用一些参数变量来代表路径，例如用$PROJ_DIR$去指向项目本身所在的文件夹，这比写死绝对路径更容易适应迁移，避免每一次换电脑都重新调整目录。

　　3、宏定义以及构建的配置没有对齐

　　同一个工程里往往会同时留着Debug、Release，还有客户定制的好几套配置，新电脑上打开以后要是不小心选错了配置，宏定义、优化等级、输出目录，甚至链接文件都会跟着变掉；所以先在工程顶部把正确的配置切换过来，然后再进到【Project】→【Options】里核实预处理宏的设置，把这一步稳下来再编译，才不会走偏方向。

　　4、链接脚本或者启动文件有缺失

　　当编译能通过、链接却反复失败时，就要把目光转向icf链接配置文件、启动文件、所用的库文件和自定义的段上面；Flash的起始地址、RAM的大小以及堆栈设置，通常都写在链接配置里面，要是这些文件在复制时被漏掉了，链接的结果一定会受到直接影响，表现出来的往往就是一堆难以理解的错误提示。

　　二、IAR工程迁移时最容易丢失哪些配置

　　IAR的工程目录里，通常会有一个ewp文件用来保存项目配置，还有一个eww文件负责组织工作区和多个项目；要是只零星地复制了其中某一个文件，工程虽然有可能勉强打开，但构建的环境未必还完整，IAR官方的迁移资料也特意把工作区文件和项目文件分开来做了说明。

　　1、处在项目外部的SDK以及公共库路径

　　许多工程会引用到项目目录以外的CMSIS、驱动库、中间件，还有芯片厂商提供的SDK，这些目录一般都不会跟着源码仓库一起移动，所以新电脑上一打开就会马上报出缺少头文件或者库文件的提示；迁移之前最好把外部依赖列成一份清单，照着它一项一项去核对，避免遗漏。

　　2、用户自己定义的参数变量

　　顺着【Tools】→【Configure Custom Argument Variables】进入设置页面，检查一下工作区变量和全局变量，IAR允许用户自行定义这类参数变量，并且支持把它们用在第三方库的路径和文件引用里面；工作区底下的局部变量常常保存在一个名叫Workspace.custom_argvars的文件里，要是忘了复制这个文件，对应的路径就没法正常展开，构建自然也就卡壳了。

　　3、编译前后需要执行的处理脚本

　　有一部分工程会在编译开始前先生成版本号，在编译结束以后再去复制hex、bin等文件，或者做一次校验，如果新电脑上缺少对应的脚本、解释器或其他辅助工具，哪怕主体代码已经顺利编译完成，整个构建任务依然会被标记为失败；迁移的时候需要去查看【Project】→【Options】里的Build Actions，看这里面是不是藏着一些容易被忽视的动作，把脚本所需的运行环境也一起配好。

　　4、许可证以及调试器相关的设置

　　新电脑上还需要确认许可证是可用状态，下载器的驱动程序已经安装到位，而且调试接口的型号以及目标芯片都选得正确；如果只是先解决编译问题，可以暂时把构建失败和下载失败当成两件不同的事分开处理，免得把不同源头的原因搅和在一起，越查越理不清。

　　三、IAR工程迁移后怎么逐项复核

　　等工程的迁移操作都做完以后，比较稳妥的方法是先执行一次彻底的干净构建，然后再去应对调试和下载遇到的问题，这样能更容易地分辨出毛病究竟出在哪个环节上。

　　1、执行一遍完整的重新编译

　　依次点击【Project】→【Clean】，再点击【Project】→【Rebuild All】；第一轮运行完之后只盯着最前面的那一行错误，把它先解决掉再接着往下查，别让后面一股脑冒出来的连带报错影响判断的方向，这么逐个击破反而能快上不少。

　　2、检查各项路径是否容易移植

　　把那些还是用着旧盘符、个人桌面目录或者临时文件夹的路径，挨个替换成$PROJ_DIR$、$TOOLKIT_DIR$这类团队里统一用惯的变量；IAR官方的文档把这些参数变量都列了出来，并且说明它们可以在路径和工具参数里直接使用，养成这种习惯以后，再碰上换电脑的场景，配置上的麻烦就会少很多，不用每次都从头点选路径。

　　3、保留好迁移所需的清单

　　正式项目建议把eww文件、ewp文件、icf文件、启动文件、用到外部库的版本信息、相关的脚本、当前IAR的版本以及构建日志，都归档保存起来；以后不管是再次换电脑，还是移到一个新的构建服务器上，照着这份清单一步步恢复就可以了，不需要每次都从零开始重新摸索。

　　总结

　　整体来看，想要搞清楚IAR工程迁移到新电脑后为什么编不过，以及迁移时最容易在不经意间弄丢哪些配置，排查的顺序大致可以缩成这么几步：先核对IAR的版本和当前的构建配置是否对应上，再依次检查头文件的路径、宏定义、链接脚本、自定义变量和构建动作。源代码只不过是整个工程项目的一个部分而已，真正容易被遗忘的，是那些躺在项目目录外部的依赖项和本机才有的设置，把这些内容全部跟着归档保存好，迁移过后再碰上编译问题，就会少出很多意料之外的麻烦。