系列前言

相信在座的读者当中，不少人启蒙时，又或者在大学课程上，使用得最多的嵌入式开发 IDE 就是 Keil MDK 。

我没有详细地去调查过这玩意的使用量到底有多大，但从网上铺天盖地的教程和使用问题问答来看， Keil 系列的用户不在少数。

即便强大如此，但其中的一些问题，盗版软件的泛滥，缺乏现代性的代码提示，上古时期的界面风格，让我不得不感到膈应，也让我感到非常地不自由。

毕竟现在都 2025 年了，VS Code 如日中天之际，还有什么理由抱着旧时代的老古董不放呢。

所以，在某个午后，无聊的我便开始尝试，使用 VS Code 和 PlatformIO 构建自己的嵌入式开发环境，也顺手将这一切记录下来，以供后人参考。

顺带一提，与本系列同时开展的，还有 「STM32：从零开始」 ，使用的框架是少见的 libopencm3 ，感兴趣的读者不妨阅读一下。

正文

这种无聊问题就不展开了。

其实除了 PlatformIO 外，还有其他一些可以和 VS Code 集成的 IDE ，比如说，「 Embedded IDE For VSCode 」。

下面是一张截自帮助文档目录的图片。

相信各位读者在翻阅 PlatformIO 帮助文档的时候，有着和我一样的困惑，这三个东西是什么关系。

官方其实对这三者的关系进行相当细致的描述，我按照自己的理解作简要的说明。

IDE

包括 CLI 和 HOME 。

为整个项目提供与 VS Code 的集成。
CLI

整个项目的核心。

烧录、编译、第三方库管理，等等相关的功能基本都在 CLI 里，~~约等于 Python 中的 pip 或者 uv ，一个 环境管理器 ~~。
HOME

一个 项目管理器 ，为用户交互提供界面，可以很方便地对项目的各种参数进行配置。

安装部分很简单，和安装任何 VS Code 插件一样，搜索安装就行。剩下的部分 PlatformIO 会自动下载。

网络不行的话可能会卡在这个环节。假如不幸卡在这个环节，网络上关于如何给 PlatformIO 设置代理的教程。

不要以为安装好 IDE 就万事大吉，对于 Linux 用户，可能还会需要设置一下 udev 规则，不然在 烧录 或者 调试 的时候，Core 尝试访问 调试器 时，会报 无访问权限 的错误。

官方也为我们提供了这个规则，里面包含了你能买到的大部分调试器，链接在文章末尾参见里可以找到。

最后修改于 2025-11-04