嵌入式开发中链接脚本(.ld)详解:从内存分配到实战避坑指南

发布时间:2026/10/8 14:01:34

嵌入式开发中链接脚本(.ld)详解:从内存分配到实战避坑指南 1. 从一次“诡异”的变量访问说起最近在调试一个嵌入式项目时遇到了一个让我百思不得其解的问题。我在一个全局结构体变量里定义了一个标志位在A模块里明明已经将它置为1了但在B模块里读取时却总是0。我检查了所有头文件包含、extern声明、编译优化选项甚至怀疑是芯片的Cache一致性出了问题折腾了大半天。最后在一位资深同事的提醒下我打开了项目的链接脚本也就是那个后缀为.ld的文件真相大白A模块和B模块编译出来的代码虽然都引用了同一个符号名但由于链接脚本里内存区域Sections分配的问题它们实际上访问的是两个不同的物理内存地址。这个经历让我深刻意识到.ld链接脚本绝不仅仅是编译流程里一个默默无闻的配置文件。对于进行MCU开发、操作系统移植、Bootloader编写乃至任何需要精细控制程序在内存中布局的工程师来说它都是必须跨越的一道坎。它直接决定了你的代码、数据、堆栈最终“住”在芯片内存的哪个“房间”而错误的“分房”方案轻则导致程序运行异常、变量访问出错就像我遇到的重则直接无法启动或者在最关键的中断服务程序里跑飞。很多人觉得链接脚本很神秘语法古怪像是一种“黑魔法”。其实不然它的核心逻辑非常清晰告诉链接器如何将输入的一堆目标文件.o中的各种“段”Section映射到输出可执行文件并最终放置到目标硬件的特定内存地址上。今天我就结合自己踩过的坑和积累的经验把这个“内存房产管理员”的工作机制掰开揉碎讲清楚。2. 链接脚本的角色内存世界的“总规划师”在理解具体语法之前我们必须建立两个核心概念输入段Input Section和输出段Output Section以及链接器Linker扮演的角色。你可以把编译过程想象成生产乐高零件。每个源文件.c经过编译器Compiler处理后生成一个目标文件.o。这个.o文件里包含的并不是最终的机器码而是一堆“乐高零件袋”每个袋子上贴着标签比如.text袋装着这个源文件里所有函数编译后的机器指令。.data袋装着所有已初始化的全局变量和静态变量并且初始值不为0。.bss袋装着所有未初始化或初始化为0的全局变量和静态变量这个袋子本身是“空”的只记录需要多大空间。.rodata袋装着只读数据比如字符串常量、const修饰的全局变量。还有其他很多自定义或编译器生成的袋子如.stack.heap.vectors等。现在你有几十个甚至上百个这样的.o文件零件袋。链接器Linker的工作就是把这些所有同名的袋子拆开把里面的零件倒出来然后按照链接脚本的指示重新装进几个新的大箱子里并且规定好每个大箱子必须放在仓库芯片内存的哪个具体货架上内存地址。这里从各个.o文件里拆出来的.text、.data等就是输入段。而链接脚本里定义的、最终要放入内存的大箱子就是输出段。链接脚本的本质就是定义这些输出段并指定这个输出段由哪些输入段的内容构成。这个输出段应该被放置在内存的哪个地址区域Memory Region。这些输出段之间的先后顺序如何。一个最常见的误区是认为代码里int a 5;这个变量a它的地址是在编译.c文件时就确定的。实际上在编译阶段编译器只处理语法、语义生成与具体地址无关的重定位代码。变量a被标记为“在.data段中的一个位置”。直到链接阶段链接器根据脚本为.data这个输出段分配了具体的起始地址例如0x20000000并确定了a在这个段内的偏移量最终才计算出a的绝对地址0x20000000 offset。这个过程叫做重定位。所以当你项目中的多个文件都引用同一个全局变量时链接器会确保所有引用点都指向它最终分配的那个唯一地址。如果链接脚本配置不当导致同一个符号被分配到了两个不同的输出段或者链接器认为它们是两个不同的实体就会出现我开头遇到的“同一变量两个地址”的灵异事件。3. 解剖一个典型的MCU链接脚本理论说得再多不如直接看一个实例。下面是一个针对ARM Cortex-M系列MCU比如STM32的简化链接脚本STM32F103xC.ld的核心部分我们逐段分析。/* 1. 定义内存区域告诉链接器芯片的“物理仓库”有多大地址在哪 */ MEMORY { RAM (xrw) : ORIGIN 0x20000000, LENGTH 64K FLASH (rx) : ORIGIN 0x08000000, LENGTH 256K } /* 2. 定义输出段规划如何组装“大箱子”并放入仓库 */ SECTIONS { /* 2.1 中断向量表必须放在Flash最开始 */ .isr_vector : { . ALIGN(4); KEEP(*(.isr_vector)) /* 收集所有输入文件中的.isr_vector段 */ . ALIGN(4); } FLASH /* 将这个输出段放入FLASH内存区域 */ /* 2.2 代码段.text和只读数据段.rodata */ .text : { . ALIGN(4); *(.text) /* 所有.text输入段 */ *(.text*) /* 所有以.text开头的输入段如.text.function_name */ *(.glue_7) /* 编译器生成的ARM/Thumb交互代码 */ *(.glue_7t) *(.eh_frame) KEEP (*(.init)) KEEP (*(.fini)) . ALIGN(4); _etext .; /* 定义一个符号记录.text段的结束地址 */ } FLASH /* 2.3 已初始化数据.data的“加载地址”和“运行地址” */ /* .data段的内容初始值需要存储在Flash中但运行时需要拷贝到RAM */ .data : AT ( _etext ) /* AT()指定加载地址在Flash中紧跟.text之后 */ { . ALIGN(4); _sdata .; /* 记录.data段在RAM中的开始地址 */ *(.data) *(.data*) . ALIGN(4); _edata .; /* 记录.data段在RAM中的结束地址 */ } RAM /* 指定运行地址在RAM区域 */ /* 2.4 未初始化数据.bss段位于RAM */ .bss : { . ALIGN(4); _sbss .; /* 记录.bss段的开始地址 */ __bss_start__ _sbss; *(.bss) *(.bss*) *(COMMON) /* 未初始化的全局变量古老格式 */ . ALIGN(4); _ebss .; /* 记录.bss段的结束地址 */ __bss_end__ _ebss; } RAM /* 2.5 用户堆栈区域定义通常由启动文件使用 */ ._user_heap_stack : { . ALIGN(8); PROVIDE ( end . ); PROVIDE ( _end . ); . . _Min_Heap_Size; . . _Min_Stack_Size; . ALIGN(8); } RAM /* 2.6 其他调试信息等不加载到芯片 */ /DISCARD/ : { libc.a ( * ) libm.a ( * ) libgcc.a ( * ) *(.note.GNU-stack) } }关键点解析MEMORY命令这是脚本的基石。它定义了目标硬件上可用的、物理的、连续的内存块。FLASH (rx)表示从0x08000000开始有256K的存储器属性为可读(r)、可执行(x)但不可写。RAM (xrw)表示从0x20000000开始有64K的内存属性为可执行、可读、可写。链接器绝不会把段分配到未定义的内存区域。输出段.data的“加载地址”与“运行地址”分离这是嵌入式开发中最核心的概念之一也是新手最容易糊涂的地方。RAM指定了它的运行地址VMA, Virtual Memory Address。这意味着程序在运行时所有访问.data段中变量的指令其寻址都是基于0x20000000开始的RAM地址。AT ( _etext )指定了它的加载地址LMA, Load Memory Address。芯片上电后存储在Flash中的程序映像包括代码和数据的初始值会被加载到内存。.data段的初始值比如int a 5;这个5在Flash映像中存放在哪里就是跟在.text段后面_etext标识的位置。因此系统启动时启动文件startup file里必须有一段代码负责将.data段从它的加载地址Flash拷贝到它的运行地址RAM。同样.bss段也需要启动代码将其全部清零。如果这个拷贝/清零过程失败你的全局变量要么初始值不对要么就是随机值。符号Symbol的定义与使用链接脚本中可以定义符号并赋值如_etext .;。这里的点号.是一个特殊的“位置计数器”代表当前输出段的地址偏移。_sdata,_edata,_sbss,_ebss这些符号其值就是在链接时计算出的绝对地址。它们会被输出到最终的程序符号表里从而可以被C代码引用。例如启动文件里就会用extern uint8_t _sdata;这样的声明来获取这些地址以便执行数据拷贝。ALIGN对齐. ALIGN(4);表示将位置计数器.推进到下一个4字节对齐的地址。内存对齐对于CPU高效访问尤其是ARM至关重要许多硬件模块也要求数据按特定边界对齐。忽略对齐可能导致硬件异常或性能下降。KEEP命令链接器默认会丢弃未被引用的输入段。KEEP(*(.isr_vector))强制保留中断向量表段即使没有代码显式引用它。这对于确保程序入口正确至关重要。4. 高级话题与实战避坑指南掌握了基本结构我们来看看更复杂的情况和那些容易踩坑的地方。4.1 将函数或变量固定到绝对地址有时你需要将某个特定的函数或变量放到一个精确的地址上。例如芯片的选项字节Option Bytes、特定外设的寄存器映射、或者Bootloader与应用程序约定的共享内存区。方法一在C代码中使用__attribute__// 将一个变量放到绝对地址0x2000C000这个地址必须在链接脚本定义的RAM区域内 uint32_t my_shared_buffer[256] __attribute__((section(.my_section), at(0x2000C000))); // GCC编译器通常不支持直接的at地址上述写法可能不通用。更通用的做法是只定义段名在链接脚本中指定地址。// 更通用的方法只指定自定义段 uint32_t my_shared_buffer[256] __attribute__((section(.shared_data)));然后在链接脚本中专门为这个段定义一个输出段并指定地址.shared_data 0x2000C000 : /* 直接在段名后跟地址 */ { KEEP(*(.shared_data)) } RAM注意at()指令在GNU LD中用于指定LMA加载地址而非VMA运行地址。对于RAM中的变量VMA和LMA通常是相同的。直接使用0x2000C000 :这种语法来指定VMA更直接。方法二完全在链接脚本中操作假设你有一个在多个C文件中都需要访问的、位于固定地址的硬件寄存器结构体。// 在hw_regs.h中 typedef struct { volatile uint32_t CR; volatile uint32_t SR; } MyPeriph_TypeDef; #define MY_PERIPH_BASE ((uint32_t)0x40021000) #define MY_PERIPH ((MyPeriph_TypeDef *) MY_PERIPH_BASE)你不需要在C代码中为这个结构体分配变量。链接脚本只需要确保没有其他数据占用0x40021000开始的地址即可。通常外设寄存器区域在MEMORY命令中不会被定义链接器不会自动向该区域分配内容因此是安全的。但为了更严谨可以在链接脚本的SECTIONS里将该区域排除或标记。MEMORY { ... /* 通常不将外设地址空间定义为可分配内存 */ } SECTIONS { ... /* 可以插入一个ASSERT语句确保代码没有意外侵入外设空间 */ ASSERT( (SIZEOF(.data) SIZEOF(.bss) ...) (0x20000000 - 0x20000000), “Error: RAM usage overlaps with peripheral area?”) }4.2 处理多块非连续内存CCRAM, DTCM, ITCM现代高性能MCU如STM32H7往往有多个内存块通用RAM、紧耦合数据内存DTCM、紧耦合指令内存ITCM、核心耦合内存CCRAM等。它们速度不同用途各异。链接脚本需要精细管理MEMORY { DTCMRAM (xrw) : ORIGIN 0x20000000, LENGTH 128K /* 最快的数据RAM */ RAM_D1 (xrw) : ORIGIN 0x24000000, LENGTH 512K /* 通用D1域RAM */ RAM_D2 (xrw) : ORIGIN 0x30000000, LENGTH 256K /* D2域RAM */ ITCMRAM (xrw) : ORIGIN 0x00000000, LENGTH 64K /* 最快的指令RAM */ FLASH (rx) : ORIGIN 0x08000000, LENGTH 2048K } SECTIONS { .text : { /* 将关键中断服务函数、性能瓶颈函数放到ITCM */ *(.text.IRQ_Handler) *(.text.SPI_Transmit_IT) /* 其他普通代码 */ *(.text) *(.text*) } ITCMRAM ATFLASH /* 运行在ITCM但初始存储在Flash */ .data : { /* 将需要极速访问的数据如算法核心数组放到DTCM */ *(.data.dsp_buffer) *(.data) *(.data*) } DTCMRAM ATFLASH .bss : { *(.bss.dsp_buffer) *(.bss) *(.bss*) } DTCMRAM .ram_d1_data : { *(.ram_d1_section) /* 其他大数据块可以放这里 */ } RAM_D1 }在C代码中通过__attribute__((section(.ram_d1_section)))将变量指定到.ram_d1_data段。这里最大的坑是启动代码的数据拷贝。原来的启动代码可能只拷贝.data段到RAM起始地址。现在你有多个.data段分布在不同的物理RAM中就必须修改启动代码为每一个需要从Flash加载初始值的段如.data、.ram_d1_data分别执行拷贝操作。同样.bss段的清零也要针对多个区域进行。4.3 链接脚本调试当程序不按预期运行时生成内存映射文件Map File这是最强大的调试工具。在GCC链接选项中加入-Wl,-Mapoutput.map。这个.map文件详细列出了所有输入文件及其贡献的段。所有输出段的起始地址、大小、由哪些输入段组成。所有全局符号函数、变量的最终地址。内存区域的使用情况。 当我遇到变量地址错乱的问题时就是在.map文件里搜索那个变量名发现它竟然出现了两次地址不同顺藤摸瓜找到了链接脚本中重复包含的问题。检查启动文件确认__main或Reset_Handler中是否正确地拷贝了所有自定义段的初始数据并清空了所有.bss段。特别是当你添加了新的内存区域或输出段后这一步必须更新。使用readelf和objdump工具arm-none-eabi-objdump -h your_elf_file.elf # 查看所有段Section的头信息包括VMA和LMA arm-none-eabi-nm -n your_elf_file.elf # 按地址顺序列出所有符号 arm-none-eabi-readelf -S your_elf_file.elf # 以更详细的格式查看段信息这些命令可以帮助你验证最终的可执行文件是否按照链接脚本的意图布局。常见错误与排查程序跑飞HardFault首先检查栈指针SP初始化地址是否有效通常在链接脚本中定义_estack。栈空间是否足够栈是否放在了速度太慢的内存里中断向量表的地址SCB-VTOR设置是否正确变量值被莫名修改检查是否有数组越界、栈溢出覆盖了.data或.bss区域。在链接脚本中确保.data、.bss和.heap/.stack区域没有重叠。使用.map文件检查各段边界。代码效率异常低下检查关键性能路径上的函数和数据是否被意外放置到了慢速内存中。通过__attribute__((section()))和链接脚本配合将其重定位到ITCM/DTCM。5. 超越基础链接脚本的进阶应用5.1 实现固件增量升级OTA的友好设计在进行OTA时我们常常需要划分Bootloader区、Application区、甚至备份区。链接脚本是定义这些区域边界的关键。MEMORY { BOOTLOADER (rx) : ORIGIN 0x08000000, LENGTH 32K APP_FLASH (rx) : ORIGIN 0x08008000, LENGTH 448K /* 留出32K给Bootloader */ RAM (xrw) : ORIGIN 0x20000000, LENGTH 128K } SECTIONS { /* 应用程序的.isr_vector需要偏移。通常Bootloader会跳转到App的Reset_Handler */ .isr_vector : { . ALIGN(4); KEEP(*(.isr_vector)) . ALIGN(4); } APP_FLASH .text : { /* 注意应用程序编译时需要知道自己的起始地址不是0x08000000 */ /* 通常通过编译器宏定义如 -DVECT_TAB_OFFSET0x8000 */ ... } APP_FLASH /* 定义一个在链接时计算的符号表示应用程序的结束地址 */ _app_end ORIGIN(APP_FLASH) LENGTH(APP_FLASH); }应用程序的编译需要指定正确的Flash起始地址-T链接脚本和中断向量表偏移如STM32的SCB-VTOR。Bootloader在跳转前需要验证应用程序镜像的完整性如CRC校验并将应用程序的向量表地址设置到VTOR寄存器。5.2 自定义段实现模块化内存管理你可以利用自定义段为不同的软件模块分配独立的内存池便于管理和调试。// module_a.c uint8_t module_a_buffer[1024] __attribute__((section(.module_a.heap))); // module_b.c uint8_t module_b_buffer[2048] __attribute__((section(.module_b.heap)));SECTIONS { ... .module_a_heap (NOLOAD) : /* NOLOAD表示该段不占用Flash空间纯RAM */ { . ALIGN(4); _module_a_heap_start .; *(.module_a.heap) . ALIGN(4); _module_a_heap_end .; } RAM .module_b_heap (NOLOAD) : { . ALIGN(4); _module_b_heap_start .; *(.module_b.heap) . ALIGN(4); _module_b_heap_end .; } RAM /* 在.map文件中可以清晰看到各模块内存占用 */ }这样在.map文件里就能一目了然地看到每个模块的私有内存消耗防止模块间内存越界踩踏。5.3 处理复杂的对齐与填充需求某些硬件DMA或加密引擎要求数据缓冲区地址按128位、256位对齐。链接脚本可以轻松实现。.my_dma_buffer : { . ALIGN(32); /* 32字节对齐 */ _my_dma_addr .; KEEP(*(.dma_buffer)) . ALIGN(32); _my_dma_end .; } RAM_D2在C代码中声明uint8_t dma_data[1024] __attribute__((aligned(32), section(.dma_buffer)));双重保险确保对齐。6. 工具链与生态的差异虽然原理相通但不同工具链的链接脚本语法略有差异GNU LD (GCC/ARM GCC)使用我们上面讨论的语法功能最强大也最复杂。文档是ld的手册。Arm Compiler (ARMCC/ARMClang)使用分散加载文件Scatter File,.sct语法不同但逻辑类似。它使用LoadRegion和ExecutionRegion的概念。IAR使用链接器配置文件.icf语法又是另一套。当你在一个开源项目如基于GCC的STM32CubeIDE工程和一个商用项目如基于ARMCC的Keil工程之间移植时重写链接描述文件是必不可少的一步。理解核心概念内存区域、输入段、输出段、VMA/LMA比记忆特定语法更重要。最后分享一个我个人的习惯在项目初期就花时间把链接脚本调通并生成.map文件进行验证。把内存布局图画出来和硬件手册对比。这看似浪费时间实则在项目后期尤其是遇到那些“时好时坏”、“只有某个优化等级下才出现”的诡异问题时能为你节省无数个不眠之夜。链接脚本不是魔法而是你对硬件内存资源的精确规划图掌握它你就真正掌握了程序在芯片上运行的底层脉络。
延伸阅读

更多相关文章

2026/10/6 6:37:46

Git安装与配置指南:从零开始掌握版本控制核心操作

1. 先搞清楚 Git 是什么,以及为什么你需要它如果你刚开始接触编程、软件开发,或者需要管理任何类型的文本文件(比如配置文件、文档、代码),那么 Git 是你绕不开的第一个工具。它不是某个编程语言,而是一个版…

2026/10/8 1:38:46

自动驾驶定位安全:卫星信号脆弱性与多传感器融合防御策略

1. 危险的“信任”:当自动驾驶把命交给卫星信号最近和几个做自动驾驶感知和定位的朋友聊天,话题总绕不开一个词:“脆弱”。不是指硬件脆弱,而是指整个系统赖以生存的“信任链”中,存在一个公认的、最危险的环节。它不是…

2026/10/8 14:00:56

网络协议栈底层原理:从CPU流水线到物理链路全解析

简介:本资源是一份面向计算机等级考试三级网络技术考生及网络基础学习者的系统性知识点精要总结,聚焦核心概念梳理与应试关键点提炼。内容覆盖计算机发展史、四大特性、性能指标(MIPS/MFLOPS、MTBF/MTTR、寻道/等待时间等)、软硬件…

2026/10/8 14:00:56

TortoiseGit连接被拒?从TCP握手到SSH配置的排查指南

用 TortoiseGit 拉代码或推代码的时候,弹出一个红色报错框:“Network error: Connection refused”。这个场景我见过太多次了,说真的,第一次遇到时我也懵过——感觉网络明明是通的,浏览器也能打开网页,怎么…

2026/10/8 14:00:56

FlashInfer 提交 PR 前的自审指南:从 diff 到可辩护的代码评审

大模型深度学习算子库后端高性能计算 【免费下载链接】flashinfer FlashInfer: Kernel Library for LLM Serving 项目地址: https://gitcode.com/gh_mirrors/fl/flashinfer 点击查看 免费下载 本篇指南面向 FlashInfer 内核库的贡献者与 AI 辅助开发流程&#xff0…

2026/10/8 14:00:56

AppCode停更背后:JetBrains生态、Rider与Xcode迁移指南

2024年下半年,JetBrains官方博客放出一则消息:停止开发并停止销售AppCode。对只写后端、Web的开发者来说,这个名字可能有点陌生,长期用IntelliJ IDEA的人也只是偶尔在官网产品列表里瞥到过它。但对Objective-C、Swift开发者来说&a…

2026/10/8 14:00:56

用COM ATL开发Windows任务栏右键菜单扩展

简介:这是一套面向Windows开发者的COM外壳扩展项目源码,基于ATL实现任务栏右键菜单自定义菜单项并显示图标。资源共30个文件,主要包含C/C源代码(.cpp/.h)、COM接口定义与注册脚本(.idl/.rgs/.def&#xff0…

2026/10/8 13:55:55

医药管理系统源码拆包:从class反编译到MySQL落库的完整链路

简介:这是一套基于Java Web技术栈的医药管理系统源码,面向计算机专业学生、课程设计开发者及需要练手SSM/JSP项目的初学者,可帮助快速搭建药品进销存管理场景。系统覆盖药品添加与查看、高级查询、库存管理、类别维护与统计、购买药品、销售管…

2026/10/8 10:03:18

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/8 10:03:20

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/8 6:05:44

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/8 0:02:17

自然数立方等于连续奇数之和:从证明到编程验证

十几年来我一直游走在数学科普和编程教学这两块内容之间,对“看起来像魔法、拆开全是数学”的结论总是格外敏感。最近翻资料时又撞见一句话:任何一个自然数 m 的立方,都可以写成 m 个连续奇数之和。2 的立方等于 3 加 5,3 的立方等…

2026/10/8 0:02:17

C#上位机SSH连接实战:用SSH.NET补齐超时、批量与密钥认证

简介:这是一份基于 C# 开发的 SSH 连接功能半成品工程,原本作为另一个主项目的子功能模块,现独立打包分享。工程采用 WinForms 界面,包含源码、解决方案、安装部署工程、NuGet 依赖包及说明文档,适合正在做远程连接、网…

2026/10/8 0:02:17

Java SpringBoot一体化智能售后系统设计与实现全解析

毕业设计年年做,Java Web 方向的题目翻来覆去就那么几个,但“一体化智能售后系统”这个题,每次看到我都觉得值得认真聊一聊。它不是一个简单 curd 堆出来的管理系统,而是把客户、工单、派单、处理、回访、统计整条链路串起来的一套…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑