Arduino IDE中如何重新定义标准库的WEBSOCKETS_TCP_TIMEOUT常量？

你的问题核心是：虽然在代码里提前定义了WEBSOCKETS_TCP_TIMEOUT，但库的编译过程并没有读取到这个自定义值，原因是库的头文件可能在你的宏定义之前就被间接包含了，或者Arduino构建系统的预编译逻辑导致宏定义没有作用到库的编译阶段。

正确的解决方法 #

方法一：强制头文件包含顺序 #

在代码最开头先定义宏，紧接着手动包含WebSocket.h，再包含库的其他头文件。这样能确保WebSocket.h在读取到你的宏定义后再处理默认值：

#define WEBSOCKETS_TCP_TIMEOUT 10
#include <WebSocket.h>
#include <WebSocketsServer.h>

void setup() {
  Serial.begin(115200);
  Serial.printf("WS Timeout: %d\r\n", WEBSOCKETS_TCP_TIMEOUT);
  // 初始化WebSocket服务器逻辑
}

void loop() {
  // 服务器循环处理
}

方法二：全局编译宏定义（更可靠） #

通过编译器参数全局注入宏定义，彻底避免头文件顺序问题：

• PlatformIO用户：在项目的platformio.ini中添加编译标志：

  build_flags = -DWEBSOCKETS_TCP_TIMEOUT=10
  

• 原生Arduino IDE用户：在项目根目录创建platform.local.txt文件（对应你使用的开发板），添加：

  compiler.cpp.extra_flags=-DWEBSOCKETS_TCP_TIMEOUT=10
  

这种方式会让编译器在整个编译流程中都生效该宏定义，库的所有源文件都会使用你设置的值。

为什么之前的操作无效？ #

你之前的代码中，WebSocketsServer.h内部可能通过其他中间头文件间接包含了WebSocket.h，导致WebSocket.h在读取到你的宏定义之前就已经处理了默认值。而手动提前包含WebSocket.h，能抢占这个顺序，让你的宏优先生效。

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