arduino如何编译STM32

ID:320776 · 发表于 2026-11-10 17:07

教程】Arduino IDE 离线安装 STM32 支持包，全部装到 D 盘（实测成功版）

环境说明：Arduino IDE 2.3.8，实测对缓存目录兼容性良好，JSON 文件留在 packages 文件夹内也能正常走通。
参考博文：https://blog.csdn.net/qcmyqcmy/article/details/128126014

这套方法干了两件事：

把板子包（STM32 Core）和工具包（GCC 编译器、OpenOCD、CMSIS 等）全部安装到 D 盘，不占 C 盘，系统重装也不怕，库文件不受影响；

提供 STM32 全系列板子包（2.12.0），配合本地 JSON 索引实现纯离线安装。

一、检查包文件是否完整

打开 D:\ProgramData\ArduinoPackage\Arduino15\staging\packages\，确认里面有 9 个文件（含 JSON 索引文件）：

text
CMSIS-6.2.0.tar.bz2
CMSIS_DSP-1.16.2.tar.bz2
CMSIS_NN-7.0.0.tar.bz2
package_stmicroelectronics_index.json
STM32-2.12.0.tar.bz2
STM32Tools-2.4.0-windows.tar.bz2
STM32_SVD-1.20.0.tar.bz2
xpack-arm-none-eabi-gcc-14.2.1-1.1-win32-x64.zip
xpack-openocd-0.12.0-6-win32-x64.zip
按名称排序后应如上所示。压缩包千万不要解压，JSON 直接放在这里即可。多余的 LIST.TXT、一键目录生成.bat、解压出来的文件夹统统清理掉。

二、环境重定向：建立文件夹 + 修改配置

在 D 盘新建三个文件夹：

D:\ProgramData\ArduinoPackage\

D:\ProgramData\ArduinoPackage\ArduinoSketch\

D:\ProgramData\ArduinoPackage\Arduino15\

用记事本打开 C:\Users\Admin\.arduinoIDE\arduino-cli.yaml，内容全部替换为：

yaml
board_manager:
additional_urls:
- file:///D:/ProgramData/ArduinoPackage/Arduino15/package_stmicroelectronics_index.json
directories:
builtin:
libraries: D:\ProgramData\ArduinoPackage\Arduino15\libraries
data: d:\ProgramData\ArduinoPackage\Arduino15
user: d:\ProgramData\ArduinoPackage\ArduinoSketch
locale: zh-cn
这一步是关键：data 指向 D 盘后，后续安装的板子包和工具链都会落到 D 盘，C 盘不再膨胀；user 指向 D 盘后，自己写的 sketch 也在 D 盘。改好的 yaml 建议备份一份到 D:\ProgramData\ArduinoPackage\。

把 C 盘 C:\Users\你的用户名\AppData\Local\Arduino15 整个复制，粘贴到 D:\ProgramData\ArduinoPackage\ 下（合并/覆盖刚建的空白文件夹），这样原来 C 盘的数据一并迁移过去。

三、配置离线 JSON 与首选项

将 package_stmicroelectronics_index.json 从 packages 文件夹复制一份到 D:\ProgramData\ArduinoPackage\Arduino15\ 下。

打开 Arduino IDE → 文件 → 首选项，在"附加开发板管理器网址"填入：

text
file:///D:/ProgramData/ArduinoPackage/Arduino15/package_stmicroelectronics_index.json
（与 yaml 里的配置形成双重保险）

四、彻底重启并安装

关闭 Arduino IDE（任务管理器确认 Arduino IDE.exe 进程已结束），重新打开。

点击左侧开发板管理器，搜索 STM32，找到 2.12.0 版本的 STM32 MCU based boards，点击安装。

预期结果：JSON 指向本地、8 个压缩包齐全，IDE 不发起任何网络请求，进度条瞬间走完，显示已安装。

五、安装后你能得到什么

STM32 全系列板子包（F0/F1/F2/F3/F4/F7/G0/G4/H7/L0/L1/L4/L5/MP1/U5/WB/WL）全部就位；

ARM GCC 编译器、OpenOCD、CMSIS 等工具链一并装到 D 盘 ArduinoPackage\Arduino15\ 下；

所有库文件、sketch 都在 D 盘，系统重装后只需恢复 arduino-cli.yaml 指向，环境即原样可用。

六、常见问题

烧录报错 STM32CubeProgrammer not found (STM32_Programmer_CLI.exe)：安装 STM32CubeProgrammer，并把其 bin 目录加入系统 PATH。

开发板管理器下载失败：说明本地 JSON 路径或文件名不对，检查 yaml 与首选项两处路径是否一致、JSON 是否确实在 Arduino15\ 下。

帐号		自动登录	找回密码
密码			立即注册