嵌入式工程基础：STM32等主流MCU的工程结构、编译链接流程、启动文件、链接脚本（.sct/.ld）的作用

在进入Keil与VSCode双环境实战之前，必须先厘清嵌入式工程的基本骨架。很多开发者从“点灯”入门，却对工程内部各文件的分工、程序从Flash到RAM的搬运过程、以及链接脚本如何决定代码段落在哪里，缺乏系统性认知。本章将围绕STM32（Cortex-M内核）为代表的主流MCU，拆解工程结构、编译链接流程、启动文件与链接脚本（.sct/.ld）四大核心模块，为后续在两种IDE中配置工程打下坚实的认知基础。

2.1 工程结构：从源码到烧录文件的组织逻辑

一个规范的STM32工程，无论使用Keil MDK还是VSCode + CMake/GCC，其物理文件组织都遵循“分层隔离、职责单一”的原则。以STM32F4系列为例，典型工程包含以下目录：Core/（用户主程序与中断服务）、Drivers/（HAL库或LL库）、Startup/（启动文件）、Linker/（链接脚本）、Middlewares/（RTOS或文件系统）。这种结构不仅便于团队协作，更关键的是让编译器能够明确区分“需要编译的源文件”与“仅作为参考的头文件路径”。

在Keil中，工程文件（.uvprojx）通过分组（Group）管理源码，每个Group对应一个物理目录；而在VSCode + GCC环境中，则通过CMakeLists.txt或Makefile的add_executable与target_include_directories指令完成同样的映射。理解这种对应关系，是后续双环境迁移的核心前提。

2.2 编译链接流程：从源码到可执行映像的四步转换

嵌入式C语言的构建过程可拆解为四个阶段：预处理（Preprocessing）→ 编译（Compilation）→ 汇编（Assembly）→ 链接（Linking）。预处理展开宏与头文件；编译将C代码翻译为汇编；汇编将汇编代码转为可重定位的目标文件（.o）；链接则将多个.o文件与库文件合并，依据链接脚本生成最终的.axf（Keil）或.elf（GCC）。

链接阶段是嵌入式工程最特殊的环节——它不仅要解析符号引用，还要完成地址重定位。例如，main函数在编译时并不知道自己最终会放在Flash的哪个地址，链接器根据.sct或.ld中ER_IROM1（Keil）或FLASH (rx) : ORIGIN = 0x08000000（GCC）的规则，将代码段放置在0x08000000起始的区域。同时，链接器生成.map文件，记录每个符号的最终地址与占用空间，这是排查内存溢出和定位HardFault的关键工具。

// GCC链接脚本关键片段（STM32F407ZGT6）
MEMORY
{
  FLASH (rx)  : ORIGIN = 0x08000000, LENGTH = 1024K
  RAM   (xrw) : ORIGIN = 0x20000000, LENGTH = 128K
}
SECTIONS
{
  .isr_vector : { KEEP(*(.isr_vector)) } > FLASH
  .text       : { *(.text*) *(.rodata*) } > FLASH
  .data       : { *(.data*) } > RAM AT> FLASH
  .bss        : { *(.bss*) *(COMMON) } > RAM
}

2.3 启动文件：MCU上电后的“第一段代码”

启动文件（startup_stm32f4xx.s）是嵌入式工程中唯一直接用汇编编写的文件，它定义了完整的中断向量表和复位处理函数Reset_Handler。向量表存放在Flash起始地址（0x08000000），第0项为初始栈指针（MSP），第1项为复位向量，后续依次为各类外设中断入口。Cortex-M内核硬件上电后，会自动从0x08000000读取MSP，从0x08000004读取PC并跳转执行。

Reset_Handler的职责包括：调用SystemInit()配置时钟；将.data段从Flash拷贝到RAM（由__etext和_sdata等符号控制）；将.bss段清零；最后调用__main（Keil）或_start（GCC）进入C运行时环境，最终跳转至main()。这一系列操作完全依赖链接脚本中定义的符号地址，因此启动文件与链接脚本必须严格匹配。

2.4 链接脚本：内存布局的“宪法”

链接脚本是嵌入式工程中最容易被忽视却影响最深远的文件。它定义了三个核心要素：内存区域（Memory Regions）、段（Sections）的放置规则、以及符号（Symbols）的导出。以STM32F407为例，Flash共1MB（0x08000000~0x080FFFFF），RAM共128KB（0x20000000~0x2001FFFF）。链接脚本必须确保代码段（.text）、只读数据段（.rodata）落在Flash，而可读写数据段（.data）和零初始化段（.bss）落在RAM。

特别需要注意的是.data段的加载域与执行域分离：它在Flash中占据空间（用于初始值），但运行时被搬运到RAM。链接脚本通过AT> FLASH（GCC）或LOAD_REGION（Keil）描述这种双重属性。此外，堆（Heap）和栈（Stack）的大小也由链接脚本预留，Keil在.sct中通过ARM_LIB_HEAP和ARM_LIB_STACK符号指定，GCC则在.ld中通过_estack和_Min_Heap_Size定义。

2.5 常见误区与排障复盘

误区一：认为启动文件是“固定模板”无需修改。实际上，当使用RTOS（如FreeRTOS）时，需要将PendSV_Handler、SVC_Handler等中断向量改为指向RTOS提供的函数，否则任务调度无法触发。误区二：混淆.sct与.ld的语法，在Keil中直接粘贴GCC的MEMORY块，导致链接器报错。误区三：忽略--specs=nano.specs（GCC）或--library_type=microlib（Keil）的差异，导致printf重定向行为不一致。

排障时，建议按以下顺序检查：先看.map文件确认各段地址是否合理；再查启动文件中__initial_sp是否与链接脚本的栈顶一致；最后用调试器查看复位后PC是否跳转至Reset_Handler。若PC停在0xFFFFFFFE，通常是向量表地址错误或芯片未正确进入Boot模式。