Arduino C++项目中公用函数如何访问不同cpp文件的全局变量

你当前的写法违反C++的单定义规则（ODR）：两个翻译单元（fileone.cpp、filetwo.cpp）都定义了同名的全局变量question_is_stupid，链接阶段要么直接报重定义错误，要么只会保留其中一个变量的实例，完全无法实现「函数访问调用方对应变量」的需求。

以下是可落地的解决方案，按推荐优先级排序：

方案1：上下文结构体封装（最推荐，符合C++编码规范） #

将所有被公共函数依赖的全局变量打包为一个上下文结构体，调用公共函数时只需要传入结构体的引用/指针，不需要逐个传参，后续新增依赖变量也只需要修改结构体定义，不需要调整函数签名。

代码实现示例： #

1. 修改utilities.h定义上下文结构体和函数签名

// utilities.h
// Arduino的boolean类型等价于C++的bool，若编译报错可替换为bool
struct AppContext {
    boolean question_is_stupid;
    // 剩余9个依赖的全局变量全部放到这里定义
};

int answer_the_question(const AppContext& ctx);

2. 修改utilities.cpp实现函数逻辑

// utilities.cpp
#include "utilities.h"

int answer_the_question(const AppContext& ctx) {
    return ctx.question_is_stupid ? 1 : 0;
}

3. 调整业务文件的变量定义和调用逻辑

// fileone.cpp
#include "utilities.h"

AppContext file_one_ctx = {
    .question_is_stupid = false,
    // 其他变量按业务需求初始化
};

int result = answer_the_question(file_one_ctx); // 返回0

// filetwo.cpp
#include "utilities.h"

AppContext file_two_ctx = {
    .question_is_stupid = true,
    // 其他变量按业务需求初始化
};

int result = answer_the_question(file_two_ctx); // 返回1

这个方案无全局变量污染，线程安全，可维护性最高，是工业级项目的通用实现方式。

方案2：全局上下文指针（适合调用链长的场景） #

如果调用公共函数的链路很深，每层都传上下文参数过于繁琐，可以在公共模块内部维护一个静态的上下文指针，调用公共函数前先设置当前使用的上下文，不需要修改原有函数的参数列表。

代码实现示例： #

1. 修改utilities.h

// utilities.h
struct AppContext;

void set_current_context(const AppContext* ctx);
int answer_the_question();

2. 修改utilities.cpp

// utilities.cpp
#include "utilities.h"
#include <assert.h>

// 静态变量仅在utilities翻译单元可见，无全局污染
static const AppContext* current_ctx = nullptr;

void set_current_context(const AppContext* ctx) {
    current_ctx = ctx;
}

int answer_the_question() {
    assert(current_ctx != nullptr); // 调试阶段检查上下文是否已设置
    return current_ctx->question_is_stupid ? 1 : 0;
}

3. 业务文件调用逻辑

// fileone.cpp调用示例
set_current_context(&file_one_ctx);
int result = answer_the_question();

如果是多线程环境，需要把current_ctx改为thread_local存储，避免线程间上下文冲突。

方案3：模板函数实现（适合变量编译期可确定的场景） #

如果依赖的变量都是编译期常量，可以把公共函数改为模板函数，直接把变量作为模板参数传递，运行期无额外性能损耗。

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