STM32CubeIDE 内存分区｜变量 / 函数 / 文件指定内存实操

在 STM32 开发中，常遇到关键变量放高速 RAM、核心代码隔离、Flash 分区存储等需求。直接用默认内存分布，易出现地址冲突、性能不足、安全隔离不到位等问题。STM32CubeIDE 依托ld 链接脚本，可灵活指定变量、函数、文件到任意内存地址。本文基于 ST 官方 LAT1616 文档，以 STM32G474（512KB Flash/128KB RAM）+ NUCLEO-G474 开发板为例，拆解完整实操流程，新手也能直接落地。

资料获取：经验分享 | LAT1616 STM32CubeIDE实用技巧之如何指定变量_函数_文件到指定内存上

1. 需求场景：为什么要指定内存

实际项目中，内存指定需求高频出现：

高速实时变量放片内高速 RAM，提升访问速度；
核心功能代码、安全代码隔离到独立 Flash 分区，防止误改写；
大数组、缓存区分配到空闲 RAM 块，避免栈溢出；
启动代码、中断向量固定到指定 Flash 地址，适配硬件启动逻辑。

STM32CubeIDE 默认内存分配无法满足定制化需求，修改 ld 链接脚本是最直接、高效的解决方案。

2. 核心原理：ld 链接脚本掌控内存

STM32CubeIDE 通过.ld链接脚本定义内存布局，核心是两个部分：

MEMORY 段：划分物理内存块，定义起始地址、大小、读写权限（RAM 可读写、Flash 只读可执行）；
SECTIONS 段：将代码、变量段分配到指定内存块，实现精准映射。

简单说：MEMORY 划地盘，SECTIONS 分东西，按需分配变量、函数、文件到目标地址。

3. 实操一：指定变量到特定 RAM

目标示例：将自定义变量放到0x20010000 起始的 64KB RAM，变量初始值存到0x08010000 起始 Flash。

第一步：修改 ld 脚本，划分内存块

打开工程ld文件，在MEMORY区域新增自定义内存：

/* 原默认内存 */
RAM (xrw) : ORIGIN = 0x20000000, LENGTH = 64K
FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 64K

/* 新增自定义内存 */
MY_RAM (xrw) : ORIGIN = 0x20010000, LENGTH = 64K  // 自定义RAM
MY_FLASH (rx) : ORIGIN = 0x08010000, LENGTH = 448K // 自定义Flash

MY_RAM：可读写，起始 0x20010000，64KB；
MY_FLASH：只读可执行，起始 0x08010000，剩余 448KB Flash。

第二步：新增变量段分配

在SECTIONS区域新增变量段，绑定 MY_RAM：

/* 自定义变量段：存到MY_RAM，初始值从MY_FLASH加载 */
.mydata : 
{
    . = ALIGN(4);          // 4字节对齐
    _smydata = .;          // 段起始地址
    *(.mydata.my_variables)// 匹配自定义变量段
    . = ALIGN(4);
    _emydata = .;          // 段结束地址
} > MY_RAM AT> MY_FLASH

第三步：启动文件初始化变量

RAM 上电随机，需在启动文件添加初始化代码，将 Flash 中的初始值拷贝到 MY_RAM：

/* 拷贝自定义变量段 */
ldr r0, =_smydata
ldr r1, =_emydata
ldr r2, =_simydata
movs r3, #0
LoopCopyMyData:
ldr r4, [r2, r3]
str r4, [r0, r3]
adds r3, r3
adds r4, r0, r3
cmp r4, r1
bcc LoopCopyMyData

第四步：代码修饰变量

用__attribute__关键字绑定变量到自定义段：

// 结构体变量指定到MY_RAM
COM_InitTypeDef BspCOMInit __attribute__((section(".mydata.my_variables")));
// 全局数组指定到MY_RAM
uint8_t buffer[1024] __attribute__((section(".mydata.my_variables")));

验证：查看 map 文件

编译工程，打开.map文件，可看到变量地址：

.mydata 0x20010000 0x10
0x20010000 BspCOMInit

变量成功分配到 0x20010000 起始的 MY_RAM，配置生效。

4. 实操二：指定函数到特定 Flash

目标示例：将 3 个核心函数放到 0x08010000 起始的 MY_FLASH。

4.1 ld 脚本新增函数段

在SECTIONS区域新增函数段，必须放在.text 段之前：

.my_code_section : 
{
    . = ALIGN(4);
    *(.my_section.*) // 匹配自定义函数段
    . = ALIGN(4);
} > MY_FLASH

4.2 代码修饰函数

给目标函数添加段修饰，声明顺序 = 内存存储顺序：

// 函数绑定到自定义段
void My_Func_1(void) __attribute__((section(".my_section.func1")));
void My_Func_2(void) __attribute__((section(".my_section.func2")));
void My_Func_3(void) __attribute__((section(".my_section.func3")));

// 函数实现
void My_Func_1(void) { /* 核心逻辑 */ }
void My_Func_2(void) { /* 核心逻辑 */ }
void My_Func_3(void) { /* 核心逻辑 */ }

4.3 验证：map 文件查看函数地址

编译后查看 map 文件，函数地址均在 MY_FLASH（0x08010000）范围内：

.my_code_section 0x08010000 0x388
0x08010000 My_Func_1
0x08010020 My_Func_2
0x08010040 My_Func_3

5. 实操三：指定整个文件到特定 Flash

目标示例：将 main.c、sysmem.c 整个文件放到 MY_FLASH。

5.1 ld 脚本指定文件路径

在.my_code_section段中，直接绑定工程内文件路径：

.my_code_section : 
{
    . = ALIGN(4);
    // 指定文件：路径为工程相对路径
    ./Application/User/Core/main.o(.text .text*)
    ./Application/User/Core/sysmem.o(.text .text*)
    *(.my_section.*)
    . = ALIGN(4);
} > MY_FLASH

⚠️ 注意：路径是STM32CubeIDE 工程路径，不是电脑本地路径！

5.2 验证：map 文件查看文件地址

编译后可看到 main.o、sysmem.o 的代码段均在 MY_FLASH 区域，整个文件成功分区。

6. 关键避坑要点

内存对齐：段必须 4 字节对齐，否则编译报错或地址错乱；
段顺序：自定义代码段必须放在.text段前，避免被默认段覆盖；
RAM 初始化：自定义 RAM 变量必须在启动文件拷贝初始值，否则上电值异常；
路径正确：文件路径用工程相对路径，绝对路径会编译失败；
权限匹配：RAM 设为 xrw（可读写）、Flash 设为 rx（只读可执行），权限错误会触发硬件异常。

STM32CubeIDE 通过 ld 链接脚本，可轻松实现变量、函数、文件的精准内存分配，无需复杂底层修改。核心三步：划分内存块→分配代码段→代码修饰绑定，适配高速变量、核心代码隔离、分区存储等各类场景。