如何避免Arduino HW262库中常量命名空间的代码重复？

要消除hw262_lib.cpp和hw262_lib.h中PINS命名空间的重复定义，只需遵循C++库的基本组织规则：将常量的定义放在头文件中，实现文件仅包含头文件并使用这些常量，具体操作如下：

1. 保留头文件hw262_lib.h的定义 #

头文件是对外暴露的接口载体，保留PINS命名空间的完整定义即可，原内容无需改动：

#ifndef HW262_LIB_H
#define HW262_LIB_H

#include <Arduino.h>

namespace HW262 {
    namespace PINS {
        const int S1 = A1;
        const int S2 = A2;
        const int S3 = A3;

        // LEDs
        const int D1 = 13;
        const int D2 = 12;
        const int D3 = 11;
        const int D4 = 10;

        // Buzzer (non-active)
        const int LS = 3;

        // On-board LED 4-digit 7-segment display, driven by dual 74HC595D shift registers
        const int SR_DATA = 8;  // SDI (data)
        const int SR_CLOCK = 7; // SFTCLK (clock)
        const int SR_LATCH = 4; // LCHCLK (latch)
    }

    namespace buttons {
        void init();
    }

    namespace leds {
        void init();
    }
}

#endif

2. 修改实现文件hw262_lib.cpp #

删除文件内重复的PINS命名空间，新增包含头文件的语句，让库的实现代码直接复用头文件中的引脚常量：

#include <Arduino.h>
#include "hw262_lib.h"  // 引入头文件获取PINS定义

namespace HW262 {

    namespace buttons {
        void init() {
            pinMode(PINS::S1, INPUT_PULLUP);
            pinMode(PINS::S2, INPUT_PULLUP);
            pinMode(PINS::S3, INPUT_PULLUP);
        }
    }

    namespace leds {
        void init() {
            pinMode(PINS::D1, OUTPUT);
            digitalWrite(PINS::D1, HIGH);
            pinMode(PINS::D2, OUTPUT);
            digitalWrite(PINS::D2, HIGH);
            pinMode(PINS::D3, OUTPUT);
            digitalWrite(PINS::D3, HIGH);
            pinMode(PINS::D4, OUTPUT);
            digitalWrite(PINS::D4, HIGH);            
        }
    }
}

3. 主程序main.cpp无需修改 #

原代码中通过头文件访问HW262::PINS的逻辑完全有效，保持原样即可。

原理说明 #

头文件的核心作用是提供对外的接口（常量、函数声明等），实现文件负责具体功能的编写。将引脚常量统一放在头文件中，既可供主程序直接调用，也能让库的实现代码通过引入头文件复用，从根源上避免了代码重复。对于const类型的整型常量，编译器会自动优化存储，不会因多文件包含产生符号冲突问题。

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