VS code配置Arduino开发环境

前言

最近习惯了使用Baidu Comate辅助写代码，于是就想从Arduino IDE迁移到VS code。

Arduino-cli安装

VS Code推荐调用Arduino-cli而不是Arduino IDE, 尤其是不支持Arduino IDE 2.0之后的版本，所以最好还是安装一下Arduino-cli。非常简单，直接去Arduino官网，在下面的Latest Release那里选择适应自己的版本就行。可以选择的是Windows exe 64bit版本，也可以选择msi版本。区别在于前者解压后需要自己把文件夹放到合适位置，然后把包含Arduino-cli.exe的文件夹添加到环境变量Path里面去，后者直接点击安装后会自己添加到环境变量。完成后打开cmd或者powershell输入

arduino-cli version

正确显示版本号就是安装成功了。

开发环境配置

我们需要添加配置文件夹

arduino-cli config init  --dest-dir "$env:LOCALAPPDATA\Arduino15"

大佬说选择这个文件夹是因为VS Code中的Arduino插件只认这个文件夹下的配置文件。如果要查看配置，可以：

arduino-cli config dump

这本质上是查看上面那个初始化的配置文件，文件名为arduino-cli.yaml。如果默认路径下没有配置文件，那显示的就是内置的默认配置。
如果你之前没有用过Arduino IDE安装第三方库，可以按网上大佬的建议修改一下user文件夹的位置，

arduino-cli config set directories.user "$env:LOCALAPPDATA\Arduino15"

否则不要修改，会找不到之前的库(哭死，之前按大佬教程搞了半天找不到库)，不小心修改这个了可以设置回来：

#注意检查下你之前的库是装在我这个位置不，点进文件夹去看看就行
arduino-cli config set directories.user "c:\Users\改成你的用户名\Documents\Arduino" 

下一步就是要下载对应的板子的核心库

# 先添加额外的链接，按需选择，多个开发板用空格分隔
arduino-cli config set board_manager.additional_urls https://hub.yzuu.cf/esp8266/Arduino/releases/download/3.1.2/package_esp8266com_index.json https://hub.yzuu.cf/espressif/arduino-esp32/releases/download/2.0.7/package_esp32_index.json

# 然后再更新一下链接
arduino-cli core update-index

# 这个时候就可以根据需要下载对应的开发板包了，我可能用到ESP32和ESP8266，所以添加了这两个
arduino-cli core install arduino:avr
arduino-cli core install esp32:esp32
arduino-cli core install esp8266:esp8266

安装完了可以清理缓存了：

# 加上-v可以看到详细输出信息
arduino-cli cache clean -v

到此为止，arduino-cli部分就配置好了，接下来配置VS Code。
多说一句，上面那些配置也可以直接打开Arduino15文件夹下面的arduino-cli.yaml进行编辑，比如我的配置打开大概是这样：

board_manager:
    additional_urls:
        - https://hub.yzuu.cf/esp8266/Arduino/releases/download/3.1.2/package_esp8266com_index.json
        - https://hub.yzuu.cf/espressif/arduino-esp32/releases/download/2.0.7/package_esp32_index.json
directories:
    builtin:
        libraries: C:\Users\你的用户名\AppData\Local\Arduino15\libraries
    data: c:\Users\你的用户名\AppData\Local\Arduino15
    downloads: C:\Users\你的用户名\AppData\Local\Arduino15\staging
    user: c:\Users\你的用户名\Documents\Arduino
library:
    enable_unsafe_install: false
没有梯子的话就不要整下面这个
network:
    proxy: socks5://127.0.0.1:7890
    user_agent_ext: daemon

VS Code配置

VS Code中的Arduino插件有好几个，推荐用Arduino for Visual Studio Code(下图的第一个)，其实还有个PlatformIO（图标是个蚂蚁）也还不错，哔哩哔哩上也有教程整那个的，不过个人感觉下面这个插件轻量化点。

点击插件的这个齿轮标志这里选Settings进行设置，在Arduino:Path这里填写之前下载的包含Arduino-cli.exe的那个文件夹，然后勾选上Arduino:Use Arduino Cli这个选项。关掉设置后重新启动VS code就可以了。
新建一个test文件夹，然后里面新建同名的test.ino文件，用VS Code打开，随便贴点简单的代码，就可以看到已经自动识别了文件类型并且添加了对应的功能。

库管理

按F1或者Shift+Ctr+P,在弹出的选项中找到Arduino Liabary Manager选项，可以看到熟悉的库管理界面

可以方便的进行库的安装和管理。
需要提醒的是，写完代码先不要急着进行C/C++的配置，先在右下角选好开发版，然后点击右上角的验证按钮（有个对勾的那个图标），这样子会自动生成c_cpp_properties.json文件。如果之前不小心先生成了这个c_cpp_properties.json文件，删除了以后再点击那个验证按钮，自动生成。如果后续要添加库，比如想引用本地文件，可以按F1了找到C/C++ 配置：UI选项，在Path里面添加路径就行。当然也可以直接修改这个json文件，更省事。
此外，可以在工程文件夹中的arduino.json文件中添加一个编译路径，在大括号里添加一句"output": "./build"就可以了，这样子后面的编译速度会更快。

乱码问题

对于输出的提示信息可能出现乱码问题，可以找到C:\Users\你的用户名.vscode\extensions\vscode-arduino.vscode-arduino-community-0.7.2-win32-x64\out\src\common\util.js文件，将下面这段给注释掉就行。

美滋滋，可以开始快乐地使用VS Code来写Arduino代码了。

参考资料

本文主要参考了CSDN博客：
https://blog.csdn.net/ZHOU_YONG915/article/details/130118049