以下是我本次项目的相关配置：

单片机：STM32F334C8T6

编译器：GCC

库文件：HAL库

其他的配置对本次教程没有影响。

安装相关工具链

这里我装的是GCC和openocd，这里装的是默认进C盘，个人建议还是在这里装吧，可能去官网下的会有兼容问题。

如果你的电脑有keil，可以不装GCC，把ARMCC的路径填进来，他就可以调用ARMCC编译器进行编译，此过程与keil没有任何关系。

安装实用工具.png

设置工具链，有个绿色的勾勾就说明能用了。

工具链.png

CubeMX生成代码配置

这一步需要注意的是，不要使用中文路径以及中文项目名称；以及在Toolchian / IDE选项选择Makefile。

新建EIDE工程并添加相关文件

新建一个空的Cotrex-M项目。

空项目.png

为项目命名，需要注意的是，EIDE的项目名称必须要和刚刚CubeMX生成的工程名称一致（CV）

命名.png

EIDE项目路径选择，这一步也需要选择和CubeMX生成代码的工程一样的路径。请确保你在打开CubeMX生成的工程所在路径的文件夹时，可以看到你使用CubeMX生成的工程名称一样的文件夹（我这里为STM32F334C8T6_TEST）。不要选中，保证弹窗底下文件夹对话框为工程路径末尾文件夹的名称（我这里为Projects）。

路径.png

确认之后，VSCode右下角会有一个弹窗提示项目文件夹已存在，说明上一步没有问题，我们要将EIDE的项目跟Cube的工程建立在同一个文件夹内。选择Yes。

创建警告.png

添加必要的项目资源文件，使用普通文件夹添加 Core 和 Drivers 两个文件夹。

请注意，这里添加的项目资源文件，是告诉EIDE你这个工程所需要的头文件和C文件所在的地方，与下文的自动检索功能直接相关，自动检索功能只会检索你添加到EIDE 项目资源的文件夹内的内容。比如：你在这个工程的根目录新建了一个Lib文件夹用于存放你个人的库文件，你就需要把Lib文件夹添加到EIDE这个项目资源文件来，他才能够自动搜索到你的库文件。

添加文件.png

添加一个虚拟文件夹用来存放.s启动文件。

这里可以不需要新建虚拟文件夹，直接添加文件找到启动文件进行添加即可。

添加虚拟文件夹.png

注意需要将文件类型修改为 asm 才会出现 .s 文件。
修改文件类型.png

根据Makefile文件对项目进行相应的配置

请注意，EIDE并不会读取Makefile的内容进行自动配置，这个Makefile文件仅在我们自己进行手动配置的时候作为参考使用，后续就算重新生成新的Makefile也不会影响EIDE的编译。

打开项目文件夹，下面我们要用到的是Makefile文件和xxx_FLASH.ld文件。
需要的文件.png

修改构建配置为GCC，将链接脚本路径改为xxx_FALSH.ld文件，直接将文件名（包括后缀）一起复制粘贴即可。
添加链接脚本路径.png

使用记事本打开Makefile文件，将CPU类型和预处理宏定义配置好。在填写预处理宏定义的时候，需要将开头的 -D 和末尾的 \ 去掉。
预处理宏定义.png

最后是对包含路径（IncludePath）和对象文件（ObjectFiles）的配置，有自动检索和手动添加两种方式。自动检索在3.8.3版本就改为了默认关闭，详见《EIDE论坛-关于新建项目设置默认值的问题》🔗

手动添加会花一点时间，不过只需要添加包含目录，也就是头文件相对应的文件夹路径。

直接对项目属性的配置文件进行修改会比一条一条添加方便一点，在Makefile中找到# C includes后接着的这些语句，将框内的部分添加到 IncludeFolders: 下，画红线的是EIDE默认的包含目录，不要去动它。复制进去删掉每一句开头 - 后面的 I 以及末尾的 \ （画横线的部分）。

包含目录.png

虽然新项目是默认关闭自动检索，但是我们也可以手动打开。进入资源管理器，打开工作区，打开 .code-workspace 文件，添加方框内的两句函数，将参数改为true保存即可，需要重启VSCode才能生效。

请注意，如果开启了文件自动检索的功能，在CubeMX生成代码的时候，请务必选择“仅复制必要的库文件”，否则自动检索机制会找到你未进行引用的头文件，然后报错。

自动搜索文件.png

关于包含路径（IncludePath）和对象文件（ObjectFiles）的配置，在EIDE拓展的设置中，有两个选项如下图：

soure设置.png

这两个选项的就是作者在3.8.3版本关闭的自动检索功能，我们把他√上，插件在编译工程的时候就会自己去检索包含路径（IncludePath）和对象文件（ObjectFiles）了。不过在新建工程的时候 . code-workspace文件里面不会添加 "EIDE.SourceTree.AutoSearchIncludePath" 和 "EIDE.SourceTree.AutoSearchObjFile" 这两句函数，当然此时插件已经默认开启了这个功能，也省了我们每次新建工程都要自己添加这两句函数。

选做：开启硬件浮点加速

硬件浮点选项选择single，构建器选项的全局选项中float ABI选择hard。
硬件浮点.png

修改完构建器选项别忘记右上角保存。

硬件浮点保存.png

全局编译一次过，完美！

编译成功.png

与MDK工程共存

这个可能是CubeMX生成代码工程的一个特性？我试着在CubeMX上改为输出MDK工程但是他并没有对文件结构产生太大的影响，VSCode仍然可以同步修改以及编译（深入的功能我还没有学那么多，不知道在哪些地方不兼容）。这也是一个好处，就是身边的小伙伴都在用keil的时候，你需要跟他们共享工程就可以直接丢给他了(●'◡'●)。
生成MDK工程.png

可以看到，文件夹中仅仅多出了一个MDK-ARM文件夹。

如果你在EIDE中添加了其他的库文件进行使用，请在Keil中进行相应的文件路径的设置。

文件对比.png

这边同样也是编译成功。
keil编译成功.png

修订历史

1.0.2303：首次发布。（于其他平台）

1.1.2441：发布到RM论坛，并且进行完善。

1.2.2442：补充关于项目资源自动检索功能的细节。

1.3.2602：将文档迁移到GitHub进行维护，后续更新将不会在此同步。

GitHub：

https://github.com/DonotFreeze/developing-STM32-in-VSCode-with-EIDE

声明

本作品采用CC BY 4.0协议授权，如需使用或转载请标明原作者与出处。