PlatformIO按环境配置lib_deps时未引用文件仍被编译失败如何解决

PlatformIO默认会遍历src目录下所有.c/.cpp/.S源文件加入编译队列，和你是否在代码中引入对应头文件无关，这是问题的根因。可以通过以下三种方法解决：

• 方法1：使用src_filter配置过滤不需要的源文件
  在platformio.ini对应环境的配置块中添加过滤规则即可，+代表保留文件，-代表排除文件。示例如下：

[env:CHA]
build_flags = -D CHA
lib_deps = 你的CHA环境依赖
# 排除OLED64对应的实现文件
src_filter = +<*> -<Displays/D_oledy64.cpp>

[env:OLED64]
build_flags = -D OLED64
lib_deps = 你的OLED64环境依赖
# 排除CHA对应的实现文件
src_filter = +<*> -<Displays/D_ledfeather.cpp>

如果有多个要排除的文件，多写几条-<路径>规则即可。

• 方法2：给实现文件套上预处理器条件判断
  直接修改对应实现文件，把整段内容用环境对应的宏包裹，示例D_oledy64.cpp的内容如下：

#ifdef OLED64
// 原来的所有D_oledy64.cpp内容都放在这里
#include "Displays/D_oledy64.h"
// 其他实现代码
#endif

这种情况下就算该文件被加入编译队列，预处理器处理后整个文件内容为空，不会触发依赖引用逻辑，也不会生成多余的目标代码，适合项目文件量小的场景，不需要修改配置文件。

• 方法3：拆分不同环境的实现为独立私有库
  把不同硬件的实现拆成独立的私有库存放在项目的lib目录下，比如lib/DisplayOLED64、lib/DisplayCHA，每个环境的lib_deps只引入对应显示的私有库即可，PlatformIO只会编译lib_deps中声明的库，不会编译未引入的私有库内容，适合大型项目、实现文件较多的场景，可维护性更高。

内容的提问来源于stack exchange，提问作者tavis