一、VSCode 软件安装
安装操作步骤
-
运行VSCode官方安装包,在许可协议界面勾选「我同意此协议」,点击下一步。
-
选择软件安装路径(示例选用D盘提前创建的目标文件夹),点击下一步。
-
勾选安装界面的所有附加任务选项,点击安装,等待程序自动完成安装流程。
-
安装完成后,安装包将自动启动VSCode软件。
二、VSCode 核心开发插件安装
所有插件均通过VSCode左侧导航栏的扩展市场搜索安装,针对STM32F103与Keil协同开发需求,需安装以下插件:
1. 中文(简体)语言包
-
在扩展市场搜索框输入
Chinese,找到微软官方发布的「中文(简体)语言包」插件,点击安装。 -
安装完成后,VSCode右下角将弹出语言切换与重启提示,点击确认后软件自动重启,界面切换为简体中文。
2. C/C++ 开发扩展
在扩展市场搜索框输入C/C++,找到微软官方发布的C/C++扩展插件,点击安装。该插件为C语言嵌入式开发提供语法高亮、代码补全、静态语法检查、代码跳转等核心能力。
3. Keil 协同开发扩展
在扩展市场搜索框输入Keil,找到适配Keil MDK与C51开发环境的协同扩展插件,点击完成安装,实现VSCode与Keil工具链的联动。
三、Keil MDK 开发环境路径配置
-
找到桌面或系统中的Keil MDK快捷方式图标,右键点击选择「属性」。
-
在属性窗口的「快捷方式」选项卡中,复制「目标」栏中的完整文件路径。
-
打开VSCode,点击左下角齿轮图标,打开「设置」界面,找到已安装的Keil协同扩展对应的配置项。
-
配置界面包含C51开发环境、MDK开发环境两个路径输入框,将复制的Keil MDK安装路径粘贴至MDK环境对应的配置项中,完成工具链路径配置。
四、Keil 工程导入与编译下载操作
-
点击VSCode左侧「资源管理器」,找到Keil工程管理面板。
-
点击打开工程,选择目标Keil工程文件,工程所在的全路径不得包含任何中文字符,避免出现编译异常。
-
工程成功加载后,通过面板功能按钮执行开发操作,核心功能定义如下:
-
编译 :对工程中发生修改的源文件执行增量编译,编译速度快,适用于日常调试
-
全局编译:对工程内所有源文件执行全量重新编译,确保所有修改与配置生效
-
下载:将编译生成的固件文件下载至STM32F103目标开发板
-
-
编译完成后,可在VSCode输出面板查看编译日志,确认编译结果是否为0错误、0警告。
五、关键注意事项
-
Keil工程的全路径(包括上级文件夹名称、工程文件名)严禁包含任何中文字符,否则会出现不可预知的编译报错与运行异常。
-
MDK环境路径配置需与Keil MDK的实际安装路径完全一致,否则VSCode无法正常调用Keil的编译工具链。
-
所有插件安装完成后,建议重启VSCode,确保插件配置与功能完全生效。