基于 VS Code 搭建 C51 单片机开发环境

相信很多人写 C51、STM32 等单片机的代码，都是在 Keil μVision 上完成的。当然，这并不是我们对 Keil 情有独钟，而是大多数人启蒙单片机都是使用了 Keil，大多数的单片机教学课程都是以 Keil 作为 IDE 进行教学。正是这些原因，使 Keil 的普及度力压其他的单片机开发软件。

作为一款收费软件（2024 年 4 月 2 日推出了免费的 Keil 社区版，只针对 MDK），Keil 有太多缺点了。比如，IDE 风格太老了，即使更新了到如今的 Keil5（C51版本还是 Keil5，MDK版本已经有 Keil6 了），跟前几代没什么太大的改变。另外，有时候出一些莫名其妙的 bug，比如明明定义的变量是对的，语法也没毛病，也按照了 C90 的标准编程，可编译就是报 error。甚至有时候是编译成功，运行不正常等等问题。另外就是代码补全，实在是不理想。

（下图为 Keil 社区版的下载页，软件 UI 还是一如既往的样子。。。）

一次在使用 VS Code 开发 ESP 单片机时，无意发现了 VS Code 也可以开发 C51 单片机，只要安装了 EIDE 插件，连 STM8、STM32 等单片机都可以在 VS Code 上开发。

EIDE（全称 Embedded IDE）是国内开发的 VS Code 插件，经过一段时间的体验，比 Keil 好太多了。因此也通过本文分享给大家去体验使用。

EIDE 官方论坛：Embedded IDE Forum (em-ide.com)

EIDE 官方手册：Embedded IDE For VSCode (em-ide.com)

当然使用这个插件写 C51 单片机程序还是要安装 Keil，因为需要用到里面的编译器和链接器，没安装的可以看我之前的博客《Keil MDK 与 Keil C51 共存的方法》安装一下。

一、VS Code 安装插件 Embedded IDE

在 VS Code 的插件窗口中，搜索并安装 “Embedded IDE”。

二、创建 EIDE 项目（C51 单片机为例）

点击左侧的 EIDE 图标，选择 New Project，然后再中间弹出的下拉菜单种选择第一个选项 Empty Project。

选择 8Bit MCU Project。

选择 8051 Empty Project(With Keil C51 Compiler)。

然后输入项目名，由于是为了写这篇博客做演示，我就命名为 test 了。

然后在弹出的窗口中，选择项目的存放路径。

确定好路径后，右下角会弹出通知，询问是否打开项目的工作空间，选择 Yes。

这样，项目就算是创建好了。

三、配置 C51 编译器

配置 C51 的编译器，只要配置一次就可以了，后面在创建项目都不需要再配置了。

点击左侧的 EIDE 图标，在偏左下角的小窗口 OPERATIONS 中，选择 Configure Toolchain，随后中间搜索框下会弹出下拉菜单，选择第一个选项 Keil C51(cx51)(ide path)。

找到 Keil C51 的安装路径，选中文件 TOOLS.INI即可。

四、编译和下载

随便写一个 LED 闪烁的程序，在 VS Code 的右上角有个 Build 按钮，这个就是编译按钮，按快捷键 F7 也是一样的效果。

编译如果通过，如下图所示。

这里要夸一下这个编译过程 Log 的输出信息，真的比 Keil 强太多了，信息很全，找错和改 Bug。

编译好后就是下载到单片机验证，同样在右上角有个箭头朝下的按钮 Program flash，这个就是用于下载程序，快捷键为 Ctrl + Alt + d。

下载过程会同步显示在终端，体验感比宏晶的 stcai-isp 好太多了。（他家的广告是真的多。。。）

五、EIDE 项目结构

项目结构也是 EIDE 的一个亮点，非常符合目前主流的代码管理，默认创建的项目结构中，有几个是与 C51 代码无关，但又非常有必要的文件夹。下面逐一介绍这些文件夹。

存放代码的文件夹为 src（source 的缩写），这个文件夹默认会帮用户创建。inc（include 的缩写）文件夹是我创建的，一般用于存放头文件。这也是软件开发过程，程序员们约定俗成的规则。

其他的文件夹解释如下：

• .eide： EIDE 项目文件夹，存放eide项目信息，日志等文件

• .vscode：VS Code 配置文件目录

• build：编译默认输出目录，可以在项目的设置中修改

• tools：编译和下载使用的 Python 程序

六、打包模板

​ 我之前的博客《C51 单片机编程模板及编码规范》中提到了关于 C51 单片机的模板和编程规范，同样，在 EIDE 中也可以创建用户自己的模板，这也方便以后创建项目，直接使用模板创建。

例如，我创建好了如下文件，想以后以此为项目模板。

在 EIED 窗口中，鼠标右键单击最上级目录弹出菜单，选择 Export As... -> Eide Project Template，这样就可以创建好模板了。

之后新建项目如果想基于这个模板，不要点 Empty Project，应该选择 Local Template。

然后根据模板的路径，选择相应的 .ept 文件就可以了。

七、串口调试

EIDE 带有一个串口调试工具，可以直接进行串口收发测试，与平时使用的串口调试助手差别不大，这些功能都集成到一个软件上，使用可以说相当的方便了。