如何同时使用两个同名Arduino库SimpleTimer？重命名报错求助

一、不合并库，实现两个同名库同时使用 #

如果不想合并，通过修改其中一个库的命名空间来区分，步骤如下：

• 找到要修改的SimpleTimer库文件夹，将其重命名为SimpleTimerAlt（避免和原库重名）
• 打开该库的SimpleTimer.h头文件：
  • 在所有#include语句之前添加命名空间声明：

    namespace SimpleTimerAlt {
    

  • 在文件最后一行添加命名空间闭合：

    } // namespace SimpleTimerAlt
    

• 打开对应的SimpleTimer.cpp源文件：
  • 在#include "SimpleTimer.h"之后添加命名空间声明：

    namespace SimpleTimerAlt {
    

  • 在文件最后一行添加命名空间闭合
• 项目代码中引用两个库：

  #include <SimpleTimer.h>       // 原库
  #include <SimpleTimerAlt/SimpleTimer.h>  // 修改后的库
  

• 使用时通过命名空间区分实例：

  SimpleTimer originalTimer;               // 原库实例
  SimpleTimerAlt::SimpleTimer alternateTimer;  // 修改后的库实例
  

二、合并两个库为一个（适合功能互补场景） #

如果两个库功能有差异且希望统一使用，可合并为一个库：

• 对比两个库的.h和.cpp文件，梳理各自独有的功能函数、成员变量
• 新建文件夹CombinedSimpleTimer，在其中创建CombinedSimpleTimer.h和CombinedSimpleTimer.cpp文件
• 整合代码：
  • 统一类名为CombinedSimpleTimer
  • 合并重复的基础函数（如定时器初始化、启停），保留两个库独有的功能
  • 处理函数名冲突：将重复的函数改名（例如把setInterval改为setIntervalMs或setIntervalUs区分精度）
• 项目中引用新库：

  #include <CombinedSimpleTimer.h>
  CombinedSimpleTimer timer;
  

三、修改库名后ESP32编译错误的排查与修复 #

改库名后编译失败，常见原因及解决步骤：

• 路径引用错误：检查项目中#include语句的路径是否和修改后的库文件夹名匹配，比如库文件夹改为SimpleTimerAlt，则需写#include <SimpleTimerAlt/SimpleTimer.h>
• 库内部引用错误：查看修改后库的.cpp文件，若存在#include "SimpleTimer.h"，确保该头文件和.cpp在同一文件夹内，无需修改路径；如果是跨文件夹引用则需调整
• 缓存问题：清理Arduino IDE缓存——打开首选项中的sketchbook文件夹，删除cache目录，重启IDE后重新编译
• 命名冲突：确认修改的命名空间未与ESP32系统库或其他第三方库重名（避免使用ESP、WiFi等已有命名空间）
• 权限问题（Windows系统）：右键修改后的库文件夹，取消"只读"属性，或重新复制库文件到新命名的文件夹中

内容的提问来源于stack exchange，提问作者a.dab