之前有在电脑上基于VS Code配置Arduino环境，大致方法就是在安装Arduino IDE的前提下在VS Code上下载一个插件并配置好Arduino IDE的路径即可，总的来说还是非常简单的。但是今天按照记忆中的方法配置的时候出现了一个弹窗：

经过反复试验，发现如果要像以前一样基于Arduino IDE来配置的话，只能忽略掉这个设置，不能点击“Use bundled arduino-cli”，否则会出问题。

  本来这个问题差不多就解决了，但是可恶的是这个弹出每次刷新窗口都会弹出来，特别讨厌。于是花了一点时间，把和arduino-cli的相关资料都仔细看了一遍，惊讶地发现这个arduino-cli特别牛逼！配置开发环境只需要它就足够了，可以完全不依赖Arduino IDE的！，这篇教程简单介绍如何在VS Code中基于arduino-cli来配置Arduino框架开发环境。

网上也有一些类似的教程，但不够细致和明确，这里从原理出发，总结一篇比较细致的教程，内容较多，请耐心观看。

  如果是使用Arduino IDE，只需要去官网下载，然后无脑安装即可，非常简单。但使用VS Code，却需要相对麻烦的配置。但付出总是有回报的，这里简单聊聊VS Code的优势和Arduino IDE的劣势。

先看看收益再决定要不要花时间。

  首先我们先来了解这个cli是什么东西。所谓cli，即Command Line Interface，是与gui（Graphic User Interface）相对，即使用命令行来实现图形界面点击按钮可完成的功能。它是官方在2018年发布的一个集成的工具，把和Arduino相关的嵌入式开发过程，如编译和下载，管理库和板子SDK等都集成到这一个工具当中。（当然，它本身是不具有编译和下载的功能的，只是调用其他工具来进行操作）这样可以实现只用这一个工具就能构建整个项目，功能非常强大。   而且这个工具是跨平台的，并且可以很方便地集成到各种流行的编辑器中，如VS Code和Eclipse等

有兴趣的可以看看官网给出的介绍

  Arduino cli这个工具更新非常快，基本几天一个版本，所以建议去官方GitHub下载：https://github.com/arduino/arduino-cli/releases

  Arduino cli是单个执行文件，可以下载压缩包然后放在电脑中的某个位置。但这里建议下载后缀为.msi的文件，这样在安装时会自动将安装路径添加到环境变量，比较省事。

安装好之后检验一下是否安装成功：

如果没出现报错就证明安装成功了。

上图画红色下划线的是比较重要的指令，后面会用到

  这里简单介绍两个使用技巧。

快速查询帮助指令 如果不知道某个命令后面有哪些“子命令”，就可以通过--help或-h来查询命令的使用。比如arduino-cli -h打开的是arduino-cli的帮助文档，而arduino-cli lib -h打开的是lib子命令的帮助文档。 不输入任何参数，默认也是打开帮助文档。如直接输入arduino-cli、arduino-cli lib也会打开帮助文档

Tab补全设置 这个是官方提供的一个Tab补全的操作，可以支持所有命令和参数的补全，这样在输入命令时更方便一点，前提貌似是安装Power Shell7，具体配置教程参考官网。如果不想折腾的可以跳过。

  前面提到，arduino-cli是一个集成的工具，它基本囊括了Arduino IDE常用的功能，甚至可以视为就是Arduino IDE的核心，只是缺少编辑器而已。因此，最好是理解Arduino IDE的基本功能，这样差不多可以理解配置的每一步了。

  在配置之前，首先要知道Arduino IDE有哪些目录。

  理解了Arduino IDE的文件夹结构，应该对它的工作原理有了一定认识，接下来就开始使用安装好的arduino-cli来搭建Arduino开发环境。

VS Code部分在后面，这部分可能有点难理解，但不要慌，照着做，做完可能就明白了。

之所以选择这个文件夹是因为VS Code中的Arduino插件只认这个文件夹下的配置文件，这个后面就理解了

如果要查看配置，可以：

这本质上是查看上面那个初始化的配置文件，文件名为arduino-cli.yaml。如果默认路径下没有配置文件，那显示的就是内置的默认配置。

  通过查看默认配置可知，库文件和板子SDK文件是不在同一个路径下的，个人觉得很不方便，因此修改一下配置：

这样配置文件、板子SDK文件和安装的第三方库文件都在一个路径下，如果需要找目标更加明确。

这里分享一下我的使用习惯。前面提到，Arduino软件（不管是1.8还是2.0）SDK和第三方包存放的位置是不一样的，一个在Local/Arduino15下，一个在文档/Arduino文件夹下。后者被官方设置为“用户目录”，即希望用户将写的项目代码也放在这个位置，但是个人更喜欢放在桌面这样更明显的位置。因此个人的习惯设置是将第三方包和板子的SDK放在一起，这样不管是查找第三方库还是默认库（一般在板子SDK包中），都只需要去一个路径下查找即可。如果使用Arduino，则是设置“首选项”中的“项目文件夹”；如果是使用Arduino-cli，则使用上述指令设置。

  也就是前面反复提到的SDK，不同的板子不一样，如果是只开发Arduino，那么只需要安装Arduino的开发套件即可：

  那如果我还要开发ESP8266和ESP32怎么办呢？还记得在Arduino IDE中是怎么设置的吗？先要添加一个板子的链接，一个json文件，然后再下载并安装，然后板子列表就多出了很多可选的开发板型号。

相信配置过的人都知道，在Arduino IDE中配置时失败概率非常高，往往要点击好几次下载。

  所以这里的重点就是那个packages的json文件，从以往的教程来看，这个链接老是会失效，因此建议还是找相对固定的GitHub链接：

安装指令：

第三步如果下载速度太慢，这是因为每个下载包都是从GitHub下载的，这里建议修改一下packages文件，使用镜像网站下载，速度会快不少：

建议使用查找替换，将github.com全部替换成hub.yzuu.cf，然后再执行上面的命令

安装完成之后，可以使用arduino-cli清除缓存文件

到此为止，arduino-cli部分就配置好了，接下来再看看VS Code部分如何配置

  我的建议是把“细节”模块仔细看一下，这样可能会对之后的操作更理解一些。这个插件有两个依赖项，即C/C++插件和一个串口的插件，安装的时候应该会自动安装。   安装好插件之后，如果去看这个插件的安装目录，会发现目录下已默认下载了一个Arduino CLI（就是我们前面安装的Arduino CLI，可能只有版本不一样），而插件的编译下载等功能都是依赖于这个程序实现的。

  理论上来说，已经有了一个执行程序，可以不用自己再安装，但是个人觉得还是需要再安装一遍，主要有两个理由：