从 Keil 和 IAR 转过来用 Visual Studio Code 写嵌入式 C/C已经三年多了。刚开始我只是拿它当个带高亮的高级记事本后来慢慢把代码补全、编译、烧录、调试全流程都搬了进来现在连 STM32 的工程管理和 LVGL 的界面模拟都在 VSCode 里搞定。这篇东西不是官方文档的复读是我自己从安装到配置 C/C 环境、再到配合 STM32CubeIDE、跑 LVGL PC 模拟器这些实战场景里一步步踩坑、试错、最后稳定用下来的完整记录。如果你想在 VSCode 里写 C 语言、配置编译调试环境或者打算用它来做单片机开发和 UI 模拟这篇应该能替你省下大量查资料的弯路直接照做就能跑起来。1. 为什么要从传统 IDE 换到 VSCode很多嵌入式开发者的第一反应是Keil、IAR 用得好好的为什么要折腾 VSCode我一开始也是这个想法直到被几个场景反复折磨——在 Keil 里看代码只能靠关键词搜索想跳转到定义得装插件还不一定灵工程文件一旦大起来整个 IDE 卡得不行最难受的是 Keil 对 Git 的支持基本等于零代码版本管理全靠手动备份文件夹。VSCode 的出现正好把这些痛点全解决了。1.1 VSCode 的核心定位与优势VSCode 本质上是一个编辑器不是一个“全家桶式”IDE。它通过安装扩展来补齐各种语言和工具链的支持这带来三个非常实际的收益。第一是启动速度快。相比打开 Keil 要等几十秒甚至更久VSCode 基本上秒开。我电脑上同时开着四五个窗口处理不同工程内存占用依然可控这在老笔记本上尤其重要。第二是代码编辑体验好。内置的智能感知IntelliSense、代码大纲、多光标编辑、全局搜索替换这些功能在写大工程时真的太舒服了。特别是多光标编辑批量修改同结构代码时效率翻倍Keil 里没有这种操作。第三是生态极其丰富。C/C、Python、CMake、Git 这些常用扩展都是千万级下载量遇到问题随手上网一搜就有解决方案。嵌入式领域还有 Cortex-Debug、Embedded Tools 这些专门为单片机调试设计的插件能做到断点调试、寄存器查看、外设状态监控。1.2 适合哪些人使用从 Keil/IAR 转向现代编辑器、希望提升代码编写效率的嵌入式工程师需要同时维护多个项目、对版本管理有强需求的团队做 LVGL 等 GUI 开发、需要在 PC 上快速模拟界面效果的前期开发者学生党或入门者想用一款免费、轻量、跨平台的工具上手 C 语言学习1.3 VSCode 与传统 IDE 的适用对比对比维度VSCodeKeil / IAR启动速度秒开级较慢大型工程明显卡顿代码编辑体验智能提示、多光标、跳转优秀基本编辑插件少Git 集成内置可视化操作基本没有编译调试依赖扩展和外部工具链自带工具链开箱即用跨平台Windows / Linux / macOS 全平台主要 WindowsLinux 受限界面高度自定义主题丰富界面陈旧风格固定一句话总结VSCode 适合当“前端编辑器”负责写代码、看代码、管代码真正的编译和烧录还是需要外部工具链或配合原厂 IDE。这也是很多人刚接触 VSCode 时最容易困惑的地方——装完发现不能编译以为软件有问题其实只是还没接上编译器。2. 安装与基础设置从下载到汉化一次搞定VSCode 的安装本身不难但有几个细节会影响后续使用比如安装路径的选择、环境变量的处理、扩展的安装位置很多人不在意后面配置 C/C 环境时就莫名其妙报错。2.1 下载与安装版本选择去 Visual Studio Code 官网首页就能看到下载按钮。这里有两个版本User Installer 和 System Installer区别在于安装权限和安装位置。User Installer安装到当前用户目录不需要管理员权限适合公司电脑或权限受限的环境System Installer安装到 Program Files 目录所有用户可用需要管理员权限我自己的建议个人电脑选 System Installer路径稳定后续配置 MinGW 时不容易出路径问题。公司电脑选 User Installer避免动不动弹 UAC 授权窗口。安装过程中的选项要留意这几个“添加到 PATH”必须勾选否则命令行里输 code 命令不好使“添加到桌面”个人喜好“通过 Code 打开操作菜单”建议勾上右键文件夹就能直接用 VSCode 打开非常方便2.2 界面改中文的两种方式装完默认是英文界面国内用户第一件事通常是改成中文。方法是在扩展商店搜索“Chinese (Simplified)”安装 Microsoft 官方出的简体中文语言包然后按提示重启 VSCode 即可。如果重启后发现界面还是英文检查一下右下角是否弹出了切换语言的提示框或者按 CtrlShiftPmacOS 是 CmdShiftP打开命令面板输入“Configure Display Language”选择“zh-cn”并重启。注意语言包只影响界面显示文字不影响代码和终端输出。中文路径或中文目录名依然可能导致编译工具链报错建议工程路径全部使用英文。2.3 必需扩展清单装好基础界面后先别急着写代码按需安装几个核心扩展C/CMicrosoft 官方提供智能感知、调试、代码浏览配置 C/C 环境的必备扩展C/C Extension Pack包含 C/C、CMake、CMake Tools 等一组常用扩展一次性装齐Chinese (Simplified)简体中文语言包GitLens增强 Git 可视化能力查看提交历史、代码作者非常直观Bracket Pair Colorizer 或内置的括号着色帮你快速定位括号匹配多层嵌套不眼晕Cortex-Debug调试 STM32 等 Cortex 内核芯片用支持 SWD 调试器3. C/C 环境配置全流程编译器选型到调试跑通VSCode 装好后本身不带编译器这是它和 Keil 这类集成 IDE 最大的不同。写 C 语言代码要能编译、能调试必须自己把编译器、调试器、构建配置三件事搞定。3.1 编译器选型MinGW-w64 还是 MSVCWindows 下写 C/C 有两种主流编译器选择MinGW-w64GCC 在 Windows 平台的移植版开源、轻量、兼容性好适合嵌入式开发和跨平台项目MSVC微软官方编译器集成在 Visual Studio 里对 Windows API 支持最好但体积大、许可和命令行使用灵活度一般我做嵌入式相关开发代码经常要跨 Windows、Linux 编译MinGW-w64 是首选因为工具链行为更接近 Linux 下的 GCC在 VSCode 里配置也简单。MinGW-w64 的下载建议去开源的工具链仓库获取选择 x86_64-posix-seh 版本注意别下错架构。推荐使用包管理器安装比如通过 MSYS2 或者 winlibs 这类自动化构建项目能避免很多手动配置路径的坑。3.2 配置环境变量编译器解压后找到 bin 目录比如 D:mingw64bin把这个路径添加到系统环境变量 PATH 中。验证方式是打开终端cmd 或 PowerShell输入gcc --version如果输出 gcc 版本信息说明编译器已经可以被全局调用。这一步敲不通后面 VSCode 里编译会直接报“gcc: 未找到命令”。关键点环境变量配置完后一定要重新打开 VSCode因为环境变量是进程启动时读取的不重启软件不生效。这个坑我踩过折腾了半小时以为配置错了其实就是没重启。3.3 创建第一个 C 文件并配置构建任务在 VSCode 中新建一个文件夹作为工作区最好全英文路径在里面创建 hello.c#include stdio.h int main(void) { printf(Hello from VSCode!\n); return 0; }这时候按 CtrlShiftP 输入“C/C: Add Debug Configuration”VSCode 会提示生成 .vscode 文件夹。这里更推荐手动创建配置文件更能理解每一行的含义。.vscode 文件夹下需要两个核心文件tasks.json 和 launch.json。tasks.json 负责编译只要这一段{ version: 2.0.0, tasks: [ { label: C/C: gcc build active file, type: cppbuild, command: gcc, args: [ -fdiagnostics-coloralways, -g, ${file}, -o, ${fileDirname}/${fileBasenameNoExtension}.exe, -stdc11 ], group: { kind: build, isDefault: true } } ] }几个参数解释一下-g生成调试信息必须加否则调试器找不到符号表${file}当前打开的文件${fileDirname}/${fileBasenameNoExtension}.exe输出到当前目录文件名与源文件同名扩展名 .exe-stdc11按 C11 标准编译写嵌入式代码建议按项目需求选择标准launch.json 负责调试{ version: 0.2.0, configurations: [ { name: C/C: gcc build and debug active file, type: cppdbg, request: launch, program: ${fileDirname}/${fileBasenameNoExtension}.exe, args: [], stopAtEntry: false, cwd: ${fileDirname}, environment: [], externalConsole: false, MIMode: gdb, miDebuggerPath: D:/mingw64/bin/gdb.exe, setupCommands: [ { description: Enable pretty-printing, text: -enable-pretty-printing, ignoreFailures: true } ], preLaunchTask: C/C: gcc build active file } ] }miDebuggerPath 一定改成你本机 gdb.exe 的实际路径。preLaunchTask 的值要跟 tasks.json 里的 label 完全一致否则调试前无法自动编译。3.4 编译和调试的实际操作写好文件后按 CtrlShiftB 运行构建任务终端应该出现编译输出并生成 hello.exe。如果报错优先检查这几处gcc 是否能在终端里跑起来tasks.json 的 command 是否被识别文件路径是否含有中文或空格调试直接按 F5VSCode 会自动执行 preLaunchTask 完成编译启动 gdb在代码里打上断点就能看变量值、单步执行。经验分享我调试嵌入式代码时习惯把 externalConsole 设为 false让调试输出显示在 VSCode 内嵌终端里省去弹窗切换的麻烦而且 CtrlC 停止程序也更顺滑。4. 跟 STM32CubeIDE 配合嵌入式开发的正规军玩法很多人在搜“STM32CubeIDE for Visual Studio Code 什么时候上”这说明大家在使用意向上有个真实困惑STM32CubeIDE 是 ST 官方推出的集成开发环境能不能用 VSCode 替代它、或者至少跟它配合4.1 当下最优的配合方案我的结论VSCode 不能完全替代 STM32CubeIDE但两者可以配合得很默契。STM32CubeIDE 负责三件事芯片初始化配置CubeMX 图形化界面、代码生成、以及官方工具链的下载和维护。VSCode 负责代码编辑、静态检查、Git 管理、日常阅读。标准流程是这样先用 STM32CubeMX 或 STM32CubeIDE 的 Device Configuration Tool 建好工程生成初始化代码拿到生成的 Makefile 工程或 CMake 工程用 VSCode 打开这个工程目录配合 C/C 扩展和 Make/CMake Tools 插件编写业务逻辑修改代码后回到命令行或用 VSCode 的构建任务调用 make 编译烧录用 STM32CubeProgrammer 命令行或 Cortex-Debug 配合 OpenOCD/st-link 烧录调试4.2 为什么要等官方的 VSCode 支持ST 官方其实已经在做相关工具链只是进度一直比较慢。这个工具如果真的上线最直接的好处是把 CubeMX 的图形化配置和 VSCode 的编辑体验合并到一条流水线里开发者不再需要来回切换两个软件。在这之前这个间接方案是实测最稳的CubeMX 负责初始化VSCode 负责业务代码make 负责构建STM32CubeProgrammer 负责烧录。这套流程跑下来比在 STM32CubeIDE 里写代码舒服得多。4.3 CubeMX 初始化 VSCode 开发的完整路径拿 STM32F103 做一个 Blinky 工程作为例子。第一步在 STM32CubeMX 中选好芯片型号配置系统时钟、GPIO 输出引脚、调试接口SWD在 Project Manager 里选择 Toolchain 为 Makefile生成工程。第二步用 VSCode 打开工程文件夹安装的 C/C 扩展会自动识别文件夹下的 .h 和 .c 文件。CtrlShiftP 搜索“C/C: Edit Configurations (UI)”配置 include path 指向 Core/Inc 和 Drivers 下各层头文件目录否则会满屏红波浪线报找不到头文件。第三步配置 Make Tools 或直接用终端输入 make 编译。Makefile 工程在 Windows 下需要 GNU Make 工具建议装 MSYS2 后在 MSYS2 终端里跑 make或者在 VSCode 终端里配好 PATH。第四步烧录调试。连接 ST-Link用 Cortex-Debug 扩展创建调试配置选择 stlink 接口指定编译生成的 .elf 文件路径F5 就能调试可以打断点看寄存器。注意事项STM32 工程的编译配置里float-abi、mcu 型号这些参数都已经在 CubeMX 生成的 Makefile 中写好了不要手动改否则编译报错还很难排查。5. LVGL PC 模拟器在电脑上跑 GUI 开发流LVGL 是嵌入式领域很火的图形界面库很多人用它做屏幕 UI。传统开发方式是把固件烧到板子上看效果、调坐标、改代码、重新烧录一个 UI 布局调下来一天就没了。LVGL 官方提供的 PC 模拟器可以在电脑上直接跑界面开发效率和调试速度完全不一样。5.1 VSCode LVGL 模拟器的组合方案LVGL 官方仓库里提供了多个 PC 模拟器工程常用的是基于 SDL2 或 SDL2CMake 的方案。原理很简单在 PC 上用 SDL2 模拟显示和输入事件LVGL 的绘图和事件逻辑跟嵌入式上一模一样代码可以直接移植。在 VSCode 里跑 LVGL 模拟器需要这几个组件SDL2 开发库LVGL 源码和官方模拟器工程CMake 和 Make 工具VSCode 的 CMake Tools 扩展5.2 从零跑通 LVGL 模拟器我建议直接拉取官方的 lv_port_pc_eclipse 工程虽然名字带 Eclipse但它其实是 CMake 工程VSCode 可以直接用。步骤分解克隆官方仓库注意用 --recursive 参数拉取子模块LVGL 核心代码在 lvgl 子模块里安装 SDL2 开发包Windows 下推荐用 MSYS2 的 pacman 安装 mingw-w64-x86_64-SDL2在工程根目录下新建 build 文件夹用 CMake 配置和生成构建文件用 CMake Tools 扩展在 VSCode 中选中工具链和构建目录点击 Build编译通过后运行生成的可执行文件一个带着 LVGL 官方 demo 界面的窗口就会出现。鼠标事件会模拟触摸输入点击、滑动都能直接操作界面。5.3 把 LVGL 模拟器变成自己的 UI 开发台跑通官方 demo 只是第一步真正高效的做法是把自己项目的 UI 代码填入模拟器工程在 PC 上把 layout、控件风格、鼠标交互全部调好再回灌到嵌入式工程。我通常直接修改模拟器中模拟器项目的主函数把 LVGL 的初始化换成自己的 UI 初始化函数然后通过 CMake 管理自己的源文件目录这样既能用上模拟器又能保持业务代码和嵌入式工程共用一份源文件。这个流程特别适合 LVGL 9.2 这种大版本迭代的场景先在 PC 上快速验证新版 API 的改动再决定是否升级到固件工程避免直接在板子上试错。6. 日常效率技巧与踩坑备忘最后这部分算是我个人使用 VSCode 三年多以来攒下的经验集合不算系统教程但每一条都是实际踩过坑或者实测提速的。6.1 快捷键是最值得投资的学习项很多人用 VSCode 停留在鼠标点击阶段其实效率翻倍的关键是快捷键CtrlShiftP命令面板一切操作入口CtrlP快速打开文件按文件名模糊搜索CtrlShiftF全局搜索支持正则AltClick多光标编辑F2重命名符号引用同步修改写代码时我重度依赖 F12跳转定义、AltF12快速查看定义弹窗、ShiftF12查找所有引用这三个是阅读理解大型工程的核心快捷键。6.2 工作区与任务配置的团队协作个人使用无所谓但团队协作时把 .vscode 文件夹和统一扩展清单纳入版本管理非常有用。tasks.json、launch.json、settings.json 里可以固化编译参数、调试配置、格式化规则新人拉下代码就能直接编译调试不需要再花半天配环境。比如 settings.json 里可以统一配置代码风格{ editor.formatOnSave: true, editor.renderWhitespace: all, files.associations: { *.h: c }, C_Cpp.default.cppStandard: c11 }这样团队里每个人保存代码时都会自动格式化风格一致代码审查时体验会好很多。6.3 高频问题速查问题现象可能原因解决方法gcc 提示“不是内部或外部命令”PATH 环境变量没配好或未重启重新配置环境变量并重启 VSCode调试时提示找不到 gdbmiDebuggerPath 路径错误检查 gdb.exe 实际位置并修正配置头文件报红线找不到includePath 没配置C/C 扩展配置里添加头文件目录编译通过但运行报缺 dll编译器运行时库缺失安装对应运行时库或使用静态链接LVGL 模拟器编译时报 SDL2 找不到SDL2 开发库未安装或 CMake 找不到用包管理器安装 SDL2或手动指定 SDL2_DIR最后分享一个小技巧如果你只是想在 VSCode 里快速验证一段 C 语言的写法或某个算法逻辑不需要建完整工程直接写一个单文件用 Code Runner 扩展一键运行省掉配置工程项目的过程。我经常用这种方式验证内存布局、结构体对齐、大小端等嵌入式相关的代码行为比在板子上打印日志快得多。用 VSCode 写嵌入式这三年最大的体会是它不会替你完成编译和烧录但它把代码编辑、阅读、调试、版本管理这些环节整合得非常顺滑让开发者能把精力集中在真正的业务逻辑上。如果你正在 Keil 和 VSCode 之间犹豫强烈建议先从写一个 C 文件、跑通编译调试开始一步一步把日常流程迁过来你会发现回不去了。