定长数组长度须为编译期常量，推荐用宏定义SAMPLE_SIZE；浮点数组应显式初始化为{0}；共享数组需加volatile修饰；DMA缓冲区需__attribute__((aligned(4)))对齐。
用 int 或 float 声明定长数组时，长度必须是编译期常量
在 C/C++ 中，像传感器采样点数这种“固定但可能后期调整”的长度，不能直接写成变量（比如 int n = 1024;），否则 int data[n]; 是变长数组（VLA），不被所有编译器默认支持（尤其嵌入式环境常用 C99 以下标准）。正确做法是用宏或 const 修饰的整型字面量。
-
#define SAMPLE_SIZE 1024—— 最通用，适用于裸机、RTOS、Arduino 等所有 C 环境 -
static const int SAMPLE_SIZE = 1024;—— 在 C++ 或支持 C99 的环境中可用，但某些旧编译器仍会拒绝用它做数组维度 - 避免
int n = 1024; float data[n];—— 这在 STM32 HAL + ARM-GCC 6.3 下会报错：error: variable length array declared outside of any function
初始化为零比留空更安全，尤其对浮点型传感器数据
未初始化的栈数组内容是随机值，若后续做均值、FFT 或阈值判断，可能引入不可复现的异常。显式初始化成本极低，且能规避首次读取脏数据的问题。
-
float sensor_data[SAMPLE_SIZE] = {0};—— 全部置 0，推荐用于 ADC 电压、温度等浮点采样 -
int16_t adc_raw[SAMPLE_SIZE] = {0};—— 比{}或不写初始化更明确，GCC/Clang 都能优化为 bss 段清零 - 不要写
= {}（C++11 合法但 C 不支持）或= {0,0,0,...}（维护困难） - 若需预加载校准值，可写
float offsets[SAMPLE_SIZE] = {[0 ... SAMPLE_SIZE-1] = 1.23f};（GCC 扩展，慎用于跨平台项目）
在中断服务程序（ISR）中写数组要加 volatile
当传感器数据由定时器中断触发采集（如每 1ms 读一次 ADC），主循环和 ISR 共享该数组时，编译器可能因优化把数组缓存进寄存器，导致主循环读不到最新值。
- 声明必须加
volatile：volatile int16_t adc_buffer[SAMPLE_SIZE] = {0}; -
volatile作用于整个数组类型，不是指针；int16_t volatile buffer[...]写法等效但可读性差 - 若同时需要多线程/多核访问（如 FreeRTOS 任务间传递），还需配合信号量或双缓冲，
volatile本身不保证原子性 - 别对
volatile数组做memcpy整体操作——部分编译器会优化掉，应逐元素读/写或用__builtin_memcpy（GCC）显式抑制优化
内存布局与对齐影响 DMA 传输稳定性
很多 MCU（如 STM32、ESP32）的 ADC/DMA 要求缓冲区地址按字（4 字节）或半字（2 字节）对齐，否则触发 HardFault 或采样丢点。
- 用
__attribute__((aligned(4)))强制对齐：uint16_t dma_buffer[SAMPLE_SIZE] __attribute__((aligned(4))) = {0}; - 检查实际地址：
printf("buffer addr: 0x%08lx\n", (uintptr_t)dma_buffer);—— 若末两位非00（16 进制），说明未对齐 - 避免在结构体里嵌套定义该数组，结构体自身对齐可能干扰数组起始地址
- 在 RAM 较紧张的芯片（如 GD32F103）上，对齐可能浪费最多 3 字节，但远小于一次 DMA 错误重启的代价
