ESP32-C3 Arduino自定义C++库：如何声明函数共享且无冲突的变量

你需要消除库内函数重复声明的变量，同时保证这些变量仅库内可见、不干扰主程序，有两种合适的实现方式：

方案一：将变量设为类的私有成员 #

这种方式让每个Info_Saver类实例拥有独立的变量副本，适合需要多实例的场景，主程序无法直接访问这些私有成员。

修改Info_Saver.h #

在类定义中添加private区块，声明需要共享的变量：

#ifndef INFO_SAVER_H
#define INFO_SAVER_H

#include "FS.h"
#include "FFat.h"

namespace Info_Saver{
    class Info_Saver {
        #define FORMAT_FFAT true
        private:
            char Temp_File[40];
            const char* End_File = ".csv"; // 改为const更安全，避免意外修改
            File Parameter_File;
        public:
            // 构造函数，初始化Temp_File
            Info_Saver() {
                strcpy(Temp_File, "/");
            }

            void Save_Info(char * File_Name, int Value_In);
  
            void Format_Space();
    
            void Delete_Parameter(char * File_Name);
    
            void Read_Parameter(char * File_Name, char * Value_Out);
    
            void List_Dir(const char * Dir_Name, uint8_t levels);
    };
}
#endif

修改Info_Saver.cpp #

删除每个函数内的重复变量声明，直接使用类成员：

#include "Info_Saver.h"

void Info_Saver::Info_Saver::Save_Info(char * File_Name, int Value_In) {
    strcpy(Temp_File, "/"); // 每次使用前重置
    strcat(Temp_File, File_Name);
    strcat(Temp_File, End_File); 

    Parameter_File = FFat.open(Temp_File,FILE_WRITE);
    if(!Parameter_File){
      Serial.println("- failed to open file for writing");
    } else {
      Parameter_File.print(Value_In);
      Parameter_File.print('\n');
    }
    Parameter_File.close();
}

// 其他函数（Delete_Parameter、Read_Parameter）做同样修改：
// 1. 删除函数内的Temp_File、End_File、Parameter_File声明
// 2. 开头添加strcpy(Temp_File, "/")重置路径
// 3. 直接使用类成员变量即可

方案二：用.cpp文件内的静态变量（单实例共享） #

如果你的库只需要单实例使用，或者这些变量不需要每个实例独立，可以在.cpp文件的命名空间内声明静态变量，这样变量仅在当前.cpp文件可见，主程序完全无法访问。

修改Info_Saver.cpp #

在文件开头、命名空间内部添加静态变量声明，删除函数内的重复声明：

#include "Info_Saver.h"

namespace Info_Saver {
    // 静态变量仅当前.cpp文件可见
    static char Temp_File[40] = "/";
    static const char* End_File = ".csv";
    static File Parameter_File;
}

void Info_Saver::Info_Saver::Save_Info(char * File_Name, int Value_In) {
    strcpy(Temp_File, "/"); // 每次使用前重置
    strcat(Temp_File, File_Name);
    strcat(Temp_File, End_File); 

    Parameter_File = FFat.open(Temp_File,FILE_WRITE);
    if(!Parameter_File){
      Serial.println("- failed to open file for writing");
    } else {
      Parameter_File.print(Value_In);
      Parameter_File.print('\n');
    }
    Parameter_File.close();
}

// 其他函数同样删除内部变量声明，直接使用静态变量即可

注意事项 #

• End_File是固定字符串，建议改为const char*类型，避免不必要的内存开销和意外修改。
• 使用静态变量时，要注意每次函数调用前重置Temp_File为"/"，避免残留上一次的内容导致路径错误。
• 类私有成员方案更适合面向对象的设计，支持多实例；静态变量方案更轻量化，但不支持多实例独立状态。

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