当前位置：首页 > news >正文

VS Code + Keil + AI插件（Trae）：嵌入式开发环境终极配置指南，告别Keil编辑器！

news 2026/4/18 14:09:15

VS Code + Keil + AI插件（Trae）：嵌入式开发环境终极配置指南，告别Keil编辑器！

原创不易，转载注明出处。

一、前言

各位朋友，想必你也有过这样的体验：

打开Keil uVision，那个万年不变的灰白界面，代码高亮基本靠猜。
写代码时，自动补全时有时无，仿佛在抽奖。
想看一个函数定义？要么右键跳转随缘，要么手动Ctrl+F全局搜索。
想用Git管理代码？得切到外部工具，来回倒腾。

更别提现在的AI编程助手了——GitHub Copilot、Trae、通义灵码……这些工具能帮你自动生成代码、解释晦涩的算法、甚至一键写注释。可是，当你兴冲冲地把Keil工程拖进VS Code，却发现：

满屏红色波浪线：明明Keil编译通过，VS Code却说找不到头文件。
AI读不了文件：像Trae这样的插件，总提示“Failed to read files”，能改代码却读不出内容，简直玄学。

网上教程很多，但要么只讲怎么配C/C++插件，要么只讲怎么用Keil Assistant，没有人告诉你如何让AI插件和Keil工程和谐共处。

今天，我把自己踩了三天坑才摸索出来的完整流程分享出来，保证照做就能成功。核心就两步：先让Keil Assistant生成配置，再手动“搬家”让AI看到全貌。

二、准备工作：安装必备软件与工具链

在开始配置之前，我们需要先把地基打好。这一步会安装所有必要的软件，其中有些是基础，有些则能帮你获得更好的开发体验。

软件/工具	作用	必要性
VS Code	现代化代码编辑器，我们将在这里完成所有开发工作	必须
Keil MDK	嵌入式C/C++编译器、链接器、调试器，是项目编译的核心工具链	必须
Keil Assistant	VS Code插件，连接VS Code与Keil MDK，让你在VS Code中完成编译、下载	必须
C/C++ (ms-vscode.cpptools)	VS Code插件，提供代码高亮、智能感知、跳转定义等功能	必须
Trae	VS Code插件，你的AI编程助手，辅助代码编写与理解	可选但强烈推荐
MinGW-w64	Windows平台上的GNU工具集，提供`make`等工具，用于解析Makefile项目或运行某些自动化脚本	可选

为什么需要MinGW-w64？
MinGW-w64（Minimalist GNU for Windows）在Windows上提供了一个轻量级的GNU开发环境，让你能享受到与Linux相似的开发体验。在你的工作流中，它并非必须，但在以下场景中它会非常有用：
本地代码检查：有些语言服务器（如clangd）或VS Code插件，在进行本地代码分析时需要调用gcc或clang等工具链。
项目构建：如果你的项目使用Makefile进行构建，那么就需要make工具，它包含在MinGW-w64中。同时，arm-none-eabi-gcc等交叉编译工具链的运行也可能依赖它。
跨平台开发：在Windows上模拟Linux环境，方便执行一些跨平台的脚本或工具。
虽然它不是核心编译工具（核心工具仍然是Keil），但预先配置好MinGW-w64，能为后续开发省去很多麻烦，这也是许多专业教程将其纳入安装列表的原因。

1. 安装VS Code

去官网下载安装，选稳定版即可。建议安装时勾选“添加到PATH”和“注册为支持的文件类型编辑器”。

2. 安装Keil MDK（如果你还没有）

去Keil官网下载MDK（现在叫MDK-ARM或C51，根据你的芯片）。安装时注意：

记住安装路径，默认是C:\Keil_v5（或C:\Keil_v5\ARM）。
确保你已经激活（或使用评估版，不影响编译）。

3. 在VS Code中安装三个关键插件

打开VS Code，按Ctrl+Shift+X打开扩展商店，搜索并安装：

插件名称	插件ID	作用
C/C++	ms-vscode.cpptools	语法高亮、代码跳转、调试支持
Keil Assistant	zixuankong.keil-assistant	导入Keil工程，解析编译参数
Trae	直接搜索Trae	AI编程助手（也可用通义灵码/CodeGeeX替代）

注意：不要同时安装EIDE，否则会与Keil Assistant冲突，导致配置文件混乱。

4. 安装并配置MinGW-w64（可选但推荐）

如果你的工作流中可能会用到上述提到的make或本地代码检查等功能，那么这一步就很有必要。

下载与安装

访问MinGW-w64的官方网站（如https://www.mingw-w64.org/downloads/），下载适合你系统的安装包。对于大多数用户，选择x86_64-posix-seh版本即可。
运行安装程序，选择安装路径（例如C:\mingw-w64）。安装完成后，记住这个路径。

配置环境变量
为了让系统能在任何位置找到MinGW-w64的工具，需要将它的bin目录添加到系统PATH环境变量中。

右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
在“系统变量”列表中找到Path，选中后点击“编辑”。
点击“新建”，添加MinGW-w64的bin目录的完整路径（例如C:\mingw-w64\bin）。
点击“确定”保存所有设置。

验证安装

按下Win + R，输入cmd并回车，打开命令提示符。
输入gcc --version并回车。如果能看到类似gcc (x86_64-posix-seh-rev0, Built by MinGW-W64 project)的版本信息，就说明MinGW-w64已经安装并配置成功了。

三、关键一步：告诉VS Code你的Keil装在哪里

很多同学装完插件就直接打开Keil工程，结果编译按钮是灰色的——因为插件根本找不到你的Keil编译器。

操作步骤：

点击VS Code左侧的插件图标，在已安装列表中找到Keil Assistant。
点击它右下角的“小齿轮”图标，选择“设置”。
在设置页面中，找到Keil Assistant: UV4 Path（或类似的输入框）。
填入你电脑上UV4.exe的绝对路径。默认路径通常是：
```
C:\Keil_v5\UV4\UV4.exe
```
如果你安装在其他盘，请右键桌面“Keil uVision5”快捷方式 → “打开文件所在位置”，复制地址栏路径。
如果你的项目是ARM芯片，通常还需要设置Keil Assistant: ARMCC Path，指向编译器文件夹，例如：
```
C:\Keil_v5\ARM\ARMCC\bin
```
保存设置。

验证：按Ctrl+Shift+P，输入“Keil”，如果看到“Keil Assistant: Build Current Project”等命令可用，说明路径配置成功。

四、核心操作：导入Keil工程，解决代码报错和AI读文件

这是本教程最精华的部分，请仔细跟着做，不要跳步。

场景假设

假设你的Keil工程放在：

D:\MyProject\ ├── RVMDK(UV5)\ │ └── YourProject.uvprojx ├── Doc\ ├── Output\ └── Source\

你的目标是：让VS Code的工作区是D:\MyProject（整个项目根目录），这样Trae才能访问所有文件夹；同时让Keil Assistant正确解析头文件路径，代码不报错。

第一步：先以子文件夹打开，让Keil Assistant生成配置

在VS Code中，先打开RVMDK(UV5)这个子文件夹（文件→打开文件夹→ 选择D:\MyProject\RVMDK(UV5)）。
点击左侧Keil Assistant图标，点击“Open Keil Project”，选择YourProject.uvprojx。
此时会弹出提示框：“Keil工程加载完成，是否需要切换工作区？”
- 请点击“OK”（或“Yes”）。
- 这一步会触发Keil Assistant在RVMDK(UV5)目录下自动生成.vscode文件夹，里面包含c_cpp_properties.json等关键配置文件。
你会看到之前满屏的红色波浪线消失了——说明配置生成成功。

注意：此时VS Code的工作区已经被自动切换到了RVMDK(UV5)，Trae只能看到这个子文件夹内的文件。别急，下一步我们手动搬移。

第二步：手动搬移`.vscode`配置文件夹

关闭VS Code（或者先关闭当前文件夹）。
打开文件资源管理器，进入D:\MyProject\RVMDK(UV5)，你会看到一个名为**.vscode**的文件夹（如果看不到，请开启“显示隐藏文件”）。
将这个.vscode文件夹剪切（Ctrl+X）。
回到上一级目录D:\MyProject，粘贴（Ctrl+V）这个文件夹。

第三步：重新以项目根目录打开，这次选“Later”

重新启动VS Code，点击文件→打开文件夹，选择**D:\MyProject**（项目根目录）。
再次点击Keil Assistant图标，点击“Open Keil Project”，选择同一个.uvprojx文件。
这次弹窗，请务必点击“Later”（不要点OK）。
- 因为.vscode配置文件夹已经在根目录了，C/C++插件能正确读取头文件路径，所以代码不会报错。
- 同时，VS Code的工作区是根目录，Trae可以看到整个项目的所有文件。

第四步：验证AI是否能正常读取文件

在VS Code中随便打开一个源文件（比如main.c）。
打开Trae对话框（通常是Ctrl+Shift+I或侧边栏图标），输入：“请读取当前文件内容，并解释其功能”。
如果Trae正确返回了文件内容，恭喜你，成功了！

五、为什么这样操作就能成功？（原理简述）

Keil Assistant的“OK”行为：点击OK后，插件会解析.uvprojx中的所有编译参数（宏定义、头文件路径、芯片型号等），并生成VS Code所需的c_cpp_properties.json。这个生成动作只在第一次导入并点击OK时触发。
工作区的限制：VS Code的工作区决定了插件能访问的文件范围。如果工作区是RVMDK(UV5)，那么Trae就只能看到这个子文件夹，无法读取项目根目录下的Doc、Output等。
“搬家”的精髓：让Keil Assistant在子文件夹里生成配置，然后手动把配置搬到根目录，再以根目录为工作区打开。这样既保留了配置，又扩大了AI的视野。

六、常见问题排雷（FAQ）

Q1：按照步骤做了，Trae还是提示“Failed to read files”？

检查VS Code信任设置：左下角是否显示“受限模式”？点击“信任”当前工作区。
检查.code-workspace文件：如果你保存了多根工作区，打开该文件，确保"folders"数组的第一项是{"path": "."}。如果不是，手动调整并保存。
检查Trae沙箱模式：在Trae插件设置中，暂时关闭“沙箱模式”试试。

Q2：代码仍然有红色波浪线，提示找不到头文件？

手动补充路径：打开项目根目录下的.vscode/c_cpp_properties.json，在includePath中添加你需要的额外头文件路径（例如${workspaceFolder}/Source/Inc）。
重新生成配置：删除根目录下的.vscode文件夹，回到“第一步”重新操作（先以子文件夹打开点OK生成，再搬家）。

Q3：Keil Assistant提示“请先配置Keil路径”？

回到第三章节，检查UV4.exe的路径是否正确，注意路径中不要有中文或空格。

Q4：我想用通义灵码/CodeGeeX代替Trae，流程一样吗？

完全一样。AI插件的读取权限只取决于VS Code的工作区，与具体品牌无关。

Q5：编译时报错“.NET Framework”相关？

这是因为Keil MDK依赖.NET Framework 3.5。去微软官网下载安装即可。

Q6：MinGW-w64配置后，编译时提示“无法找到gcc”或“make”？

首先，确认你已按照“准备工作”的步骤正确安装了MinGW-w64。
其次，最关键的一步是检查PATH环境变量是否配置正确。打开命令提示符，输入gcc --version，如果提示“不是内部或外部命令”，说明PATH配置有误。请回到配置步骤，仔细检查添加的路径是否是你MinGW-w64的bin文件夹路径（例如C:\mingw-w64\bin），并确保重启了命令提示符。