简介Arduino库文件大全一共收录269个常用库文件解压后包含2019个文件总大小约73.54MB。资料面向Arduino开发者和电子爱好者覆盖基础输入输出、传感器驱动、显示控制、网络通信、数据处理等常用功能适合在智能家居、物联网、创客教育等项目中直接选用省去四处查找与手动安装的麻烦。包内文件以.h头文件、.cpp源文件、.c底层驱动为主同时包含.md说明文档、.txt说明文件以及少量示例源码并能看到SD、EEPROM、LiquidCrystal、PID等典型库的代码与文档。文件结构按类型划分便于在Arduino IDE中快速导入指定库并复用其中的接口与示例进而完成传感器采集、电机控制、云端上报等典型开发任务。目前已有261人学习下载。资料整体整理相对规整适合需要系统补全Arduino生态库的初学者和想快速验证某个模块的中级开发者。使用时可结合包内说明与示例按需挑选库文件引入工程减少重复造轮子的成本。 前后共整理了两轮最后在本地 libraries 目录里躺着的 Arduino 库文件正好是 269 个。这个数字不是随手凑出来的而是这几年做传感器采集、舵机控制、智能小车、ESP32 联网项目时一点点攒下的家底。之所以把这件事专门写成一篇文章是因为我经历过一次 IDE 重装后几乎所有第三方库都丢失的狼狈也见过太多新手在群里问“下载的库解压后到底放哪里”“为什么明明装了库还是编译失败”。这篇文章就把我整理这 269 个库的思路、踩过的坑和实际项目里最常用的组合方式都讲一遍给正在被库文件问题折磨的人一个可以直接照做的方案。1. 整理269个库文件的起因一场IDE重装引发的备份教训1.1 一次重装之后我失去了什么大约半年前要换电脑我把 Arduino IDE 从旧机器迁到新机器。当时把这事想得太简单了觉得装好 IDE、配上 esp32 板卡项目打开就能编译。结果一开机报错一条接一条DHT 传感器库找不到、Adafruit_GFX 依赖缺失、SoftwareSerial 和 AltSoftSerial 冲突最头疼的是一个基于 ESP32 的联网项目连 WiFi 相关库都被 IDE 判断成“未安装”。那几天我干得最多的事就是翻旧电脑硬盘、翻浏览器下载记录、去各个论坛找当初下载过的库文件版本有些老版本库连作者都已经下架了。也是从那时候起我下定决心建立一套本地的库文件管理方案最终慢慢攒成了这份 269 个库的完整清单。1.2 库文件到底存放在哪里Arduino 库的默认位置不同系统不一样我刚入坑时就放错过好几次。Windows 上查到的路径一般是C:\Users\你的用户名\Documents\Arduino\librariesmacOS 是~/Documents/Arduino/librariesLinux 通常在~/Arduino/libraries。这里有个误区必须说清楚IDE 安装目录下也有一个 libraries 文件夹那是给内置示例和板卡支持用的第三方库不要往那里塞。另一个高频问题是解压层级下载的库压缩包很多已经有一层同名文件夹你再手动解压一次路径就变成libraries/xx库/xx库/DHT.hIDE 扫描不到编译照样报“No such file or directory”。正确做法是让库文件位置直接指向包含library.properties的那一层压缩包解开后看到这个文件就说明这个目录才是合法的库根目录。1.3 备份策略从手动复制到版本清单那次丢库的教训之后我给自己定了条规矩每个库进入 Arduino 的 libraries 目录之前先解压到单独备份目录命名统一为“库名-版本号”比如IRremote-4.4.1、TFT_eSPI-2.5.43。备份目录里同时维护一个 README 表格记录来源地址、依赖项、测试结论。这套流程听起来繁琐但当你需要重装电脑或者去合作者的机器上复现环境时只要按着 README 把库放回去几十个项目几分钟就能恢复。269 个库不是一口气攒出来的就是每次需要时按规则录入一条坚持半年多回头一数已经有了不少。1.4 除了 libraries 目录板卡核心文件同样要单独留底这是我后来补上的一课。很多人的备份只覆盖 libraries忽略了 Arduino15 这个关键文件夹。在 Windows 上它通常在C:\Users\你的用户名\AppData\Local\Arduino15里面存着 esp32、stm32、esp8266 这些板卡核心以及工具链文件。安装 esp32 开发板支持时实际操作就是把几百 MB 的包下载到这个目录如果网络条件不好或者文件源变了重下一次非常折磨。而且不同核心版本对库的 API 兼容性影响很大旧项目可能需要固定版本的板卡核心才能编译通过。所以现在我的备份策略分为两块libraries 管第三方库Arduino15 管板卡核心两边分开压缩分别记录版本号重装时按顺序恢复。2. 来源、版本、依赖下载库文件时的三道关2.1 常用下载渠道按推荐程度排个序我下载库文件的渠道主要有四类各有优劣渠道优点缺点建议Arduino 库管理器官方集成支持一键装依赖版本更新可能滞后首选GitHub Release更新快示例完整需要自己选 tag/分支新硬件支持常用芯片厂商或板卡官方仓库与特定板卡高度匹配代码可能有私有改动官方板卡优先用论坛、博客附件能找到停产或老版本来源不明风险高下载后先验证再入库很多时候看到群里有人发一个 zip 就让帮忙编译我第一反应都是问一句“你从哪下的、版本是多少”。版本信息不明确问题就无从排查。特别是在 GitHub 上不要直接下载默认分支的代码尽量选择带版本号的 Release tag因为默认分支可能正在开发中API 随时会变。2.2 三分钟验证法每拿到一个新库我会给它一套固定“入门考试”关闭 IDE把库解压到 libraries 目录重新打开 IDE先打开库自带的示例然后依次编译三个项目——任意一个 Blink、库自带示例、再加一个串口或网络相关样例。三个都能通过才放心把它用到自己的业务代码里。很多库在示例下跑得好好的放进你自己的多文件工程就翻车这通常不是库本身坏了而是你的工程里已经有同名类或同名头文件导致冲突这时候先剥离冲突部分一个个模块加回去是最快的定位方法。2.3 依赖关系边安装边排查Adafruit 家出的传感器库是典型例子。装 Adafruit_BMP280_Library光装它一个不够还需要 Adafruit Unified Sensor、Adafruit BusIO 这些支撑库。如果缺依赖编译时直接报fatal error: Adafruit_Sensor.h: No such file or directory不少人第一反应是重装主库其实缺的根本不是主库。在库管理器里如果出现“Install all dependencies”按钮点它就省心了如果是 GitHub 手动下载就需要去库的 README 或library.properties里找 depends 字段把依赖列表逐个补齐。我在自己的备份表格里专门加了一行“依赖情况”就是为了防止半年后把依赖关系忘得一干二净。3. 按功能给库分门别类269个库实际覆盖的八大功能块3.1 八大功能块的分布269 个库听起来杂乱但按功能一分类结构就非常清楚。我自己的分类结果是这样的功能块典型库代表覆盖用途传感器驱动DHT、BMP280、MPU6050、HX711、DS18B20温湿度、气压、姿态、称重、温度显示与界面U8g2、Adafruit_GFX、TFT_eSPI、LiquidCrystal、SevSegOLED、LCD、数码管、TFT 屏通信与网络Wire、SPI、SoftwareSerial、Ethernet、ModbusMasterI2C、SPI、串口、工业总线无线通信RF24、LoRa、EspMQTTClient、BLEDevice2.4G、LoRa、MQTT、低功耗蓝牙电机与执行器Servo、ESP32Servo、AccelStepper、AFMotor舵机、步进电机、直流电机数据存储SD、LittleFS、Preferences存储卡、Flash、参数持久化算法与任务处理ArduinoJson、TaskScheduler、FastLED、PID、Time、Timezone解析、任务调度、灯效、控制算法、时间杂项与应用IRremote、RTClib、Tone、OneWire红外遥控、时钟、蜂鸣器、单总线设备分好类之后每个项目需要哪些库几乎一眼就能看出来不用每次都在几百个文件夹里翻来翻去。3.2 按功能分类对项目选型有什么实际帮助举个例子做一台智能小车常见的功能块是电机驱动、红外遥控、超声波避障、电源管理对应到库清单就是 AccelStepper、IRremote、NewPing 这几个再从“算法与任务处理”里挑一个调度库负责多任务。如果你的 libraries 目录只是按字母堆在一起选型时很难想起来“原来我还有一个这么好用的库”但当你按功能块梳理过一遍项目一开始就先问自己需要哪几个功能块然后从清单里挑已知稳定的库能省掉大量试错时间。我还会给每个库标一个“使用频率”维度高频库固定版本低频库保持可用即可这个思路在老项目维护时尤其重要。3.3 容易被忽略的工具型库很多人说到库头脑里只有传感器和显示屏实际上 ArduinoJson、TaskScheduler、CircularBuffer 这些工具类库对项目健壮性的提升非常明显。比如用 ESP32 做 HTTP 请求时解析返回的 JSON 数据几乎绕不开 ArduinoJson又比如你要同时处理按键扫描、数码管刷新、串口发送三个任务TaskScheduler 比自己在 loop 里堆millis()判断要清晰得多。这类库不直接对应某个硬件但往往是项目从“能跑”变“好跑”的关键也最容易在所谓的“大全”里被低估。4. 安装时最容易翻车的四处命名、重复库、核心版本与编译顺序4.1 文件夹命名必须和 library.properties 对得上从 GitHub 下载的压缩包经常叫DHT-sensor-library-master或者IRremote-4.4.1这种带版本后缀的名字解压出来的文件夹直接拖进 libraries大多数时候能编译通过但会给后续维护埋雷。Arduino IDE 读取库信息时会同时参考文件夹名和library.properties里的 name 字段。如果文件夹名带了一堆后缀甚至出现解压两次产生的“1”之类标记IDE 可能把它当成独立库和旧版本的残留形成两个同名库编译时就会出现各种莫名冲突。我现在的习惯是解压后先把文件夹名改成规范化的库名再检查里面的library.properties确保 name 字段一致然后才放进 libraries。4.2 重复库导致的经典编译错误重复安装是绕不开的经典问题。典型场景你先在库管理器里装了旧版 A后来又到 GitHub 下载新版 A 手动解压进 libraries两个同名库同时存在。此时编译可能不会立即报错但偶尔会蹦出‘XXX’ does not name a type或者redefinition of class这种误导性很强的提示。我在整理这 269 个库的过程中养成了一个习惯每次装新库之前先搜索本地是否已有同名库有就先删掉旧版本再装新的。顺手再打开库管理器搜索一遍把管理器里残留的其他版本也清理掉从根上杜绝“看似装着实际不知道用的是哪份”的情况。4.3 开发板核心版本和库版本要门当户对ESP32 板卡核心从 2.x 升到 3.x 之后不少 API 都做了调整网上很多老项目用的 WiFi 库、MQTT 库是基于旧核心封装的换到新核心后编译错误满天飞。反过来新项目想用新库旧板卡核心又不支持。我的做法是在项目 README 里明确记录两块版本——开发板核心版本以及关键依赖库版本。这样哪怕半年后重新打开项目也能快速复现当时可以正常编译的环境而不是靠“试到能跑为止”。STM32、ESP8266 这些平台也有类似问题处理思路完全一致。4.4 从编译日志确认实际加载的库当你怀疑 IDE 用错了库版本时开启 Arduino IDE 的“详细输出”编译模式打印出来的完整编译命令里会显示每个头文件实际来自哪个路径这是最直接的证据。还有一种更快的办法很多库自带版本宏比如ARDUINOJSON_VERSION、IRREMOTE_VERSION在代码里用Serial.println输出一下就知道当前编译加载的到底是哪个版本。这个小技巧在排查重复库问题、板卡核心切换后的兼容问题时比看一堆报错信息高效得多。5. 高频场景实测舵机、红外、数码管与micro-ROS5.1 舵机控制标准 Servo 和 ESP32Servo 别混用很多从 Arduino Uno 转到 ESP32 的人第一反应是继续用自带 Servo 库结果在 ESP32 上要么编译不通、要么运行异常这是因为标准 Servo 库对 ESP32 的硬件定时器支持不完善推荐改用ESP32Servo这个第三方库。用法很接近#include ESP32Servo.h Servo myservo; void setup() { myservo.attach(13); // 注意选支持 PWM 输出的引脚 } void loop() { myservo.write(90); delay(500); }这里有个容易忽略的点不是每个 GPIO 都适合输出舵机 PWM接线前先看板卡引脚定义。我用 ESP32 做智能小车机械臂时遇到过写角度但舵机纹丝不动的情况排查到最后就是 GPIO 选错换成正确引脚后一切正常。5.2 NEC 格式红外遥控IRremote 库的简化用法红外遥控里 NEC 格式很常见IRremote 库可以直接解析。使用前先跑一遍库里自带的接收示例记下遥控器按键对应的键值。核心代码很简单#include IRremote.h const int RECV_PIN 5; void setup() { Serial.begin(115200); IrReceiver.begin(RECV_PIN, ENABLE_LED_FEEDBACK); } void loop() { if (IrReceiver.decode()) { Serial.println(IrReceiver.decodedIRData.decodedRawData, HEX); IrReceiver.resume(); } }这里特别提醒IRremote 库不同版本 API 差异很大老版本是IRrecv irrecv(pin); irrecv.enableIRIn();的写法新版本才升级成IrReceiver.begin()。如果你是照着旧教程写代码本地又装了新版本库编译报错几乎是必然的。先确认你用的是哪个版本再选对应的写法。5.3 定时器和数码管计时器摆脱空等式的轮询搜索记录里很多人问“arduino定时器使用”和“arduino数码管计时器”这两个问题本质上是一件事既要保证计时准确又不能阻塞主循环。最简单传统的方法是维护millis()差值但任务一多就乱。我后来用 TaskScheduler 库把刷新数码管、扫描按键、每隔 100ms 发串口帧分别定义成独立任务代码结构清晰很多。数码管驱动可以选择 SevSeg 这类库底层扫描交给库处理你只需要更新显示值。做一个多小时倒计时器稳定性完全够用。5.4 ESP32 与 micro-ROS库文件之外还有一张依赖网ESP32 和 micro-ROS 的组合是最近热度比较高的方向。通过micro_ros_arduino库可以让 ESP32 在 Arduino 环境中作为 ROS2 节点通过 WiFi 或串口连接机器人通信网络进行话题订阅和发布。这个库想成功编译前提往往不只是“把库解压进去”这么简单还涉及板卡核心版本、micro-ROS 生成头文件和具体硬件平台的匹配。建议项目一开始就用官方最小示例打通“WiFi 连接—agent 握手—话题收发”这条链路再逐步加入业务逻辑。如果中途报一堆深层头文件错误先回头看核心版本是否和库的说明一致而不是盲目更新库。最后分享一点个人体会269 这个数字看起来很有规模感但实际项目里中高频使用的库可能只有三四十个。真正的价值不在于收藏的库数量多而在于每次离线重装、换电脑、换板卡时你能从这份清单里快速找到“上个项目是用哪个库、哪个版本跑通的”以及能不能三分钟内复现出同样的编译环境。如果你也在整理自己的 Arduino 库文件我的建议很简单从现在开始给每个库加一行版本和来源记录三个月后你回头看会感谢这个决定。本文还有配套的精品资源点击获取