arm-none-eabi-gcc是唯一适配stm32的交叉编译器，普通gcc生成的x86代码无法在arm cortex-m上运行；必须使用arm-none-eabi-gcc并配合-mcpu、-mfloat-abi、-ffreestanding等参数及正确链接脚本才能生成可执行固件。
arm-none-eabi-gcc 是唯一能生成 STM32 可执行代码的 GCC 变体，用普通 gcc 编译出来的文件在 STM32 上根本跑不起来——它连启动代码都识别不了，更别说跳转到 main。
确认你装的是正确的交叉编译器
很多人卡在第一步：以为自己装了“GCC”，其实只是宿主机的 x86_64 版本。STM32 是 ARM Cortex-M 架构，必须用专为嵌入式裸机设计的 arm-none-eabi-gcc。
- 检查命令：
arm-none-eabi-gcc -v—— 如果报 “command not found”，说明没装对，或没加进PATH - 推荐版本：截至 2026 年中，
arm-gnu-toolchain-14.3.rel1最稳；15.x 系列存在链接器段对齐 bug，烧录后常卡在复位向量 - Windows 用户注意：别下错包名 —— 要选
arm-gnu-toolchain-*-mingw-w64-i686-arm-none-eabi.zip，不是gnueabihf（那是给 Linux 应用用的） - Linux/macOS 用户：从 Arm 官网下载
arm-gnu-toolchain-*-x86_64-arm-none-eabi.tar.xz，解压后把bin/加入PATH
Makefile 里必须显式调用交叉工具链
即使环境变量里有 arm-none-eabi-gcc，Makefile 里也得写死前缀，否则 make 默认调用系统 gcc，静默失败。
- 定义工具链变量：
CC = arm-none-eabi-gcc、AS = arm-none-eabi-gcc（ARM 汇编也走 gcc）、LD = arm-none-eabi-gcc（链接也用它，不是ld） - 关键参数不能少：
-mcpu=cortex-m4 -mfloat-abi=hard -mfpu=fpv4-d16（按你芯片型号调整，M3/M4/M7 参数不同） - 必须指定
-ffreestanding：告诉编译器不要依赖标准 C 库（STM32 没 libc） - 链接时加
-T stm32f407vgtx.ld：链接脚本决定代码段、数据段、堆栈位置，缺了就乱放地址，烧进去直接不启动
常见错误现象和对应 fix
编译成功 ≠ 能跑。很多问题出现在链接或启动阶段，现象很隐蔽。
-
串口没输出、LED 不闪 → 大概率是向量表没对齐或没加载：检查
startup_*.s是否被编译进去了，RESET向量是否指向正确地址（通常0x08000000） -
gdb 连上但停在
0xfffffffe→ 典型栈溢出或未初始化 SP 寄存器，检查启动文件里_estack定义是否超出 RAM 范围 -
undefined reference to `__libc_init_array'→ 用了-lc或没加-nostdlib，裸机项目必须禁用标准库 -
烧录后复位死循环 → 检查
SystemInit()是否被跳过（HAL 库里常因时钟配置错误卡住），或 Flash 基址和链接脚本不匹配
验证输出是否真的适合 STM32
别只信 .elf 文件大小，得看它生成的内容是不是 ARM 指令。
- 用
arm-none-eabi-readelf -h your_project.elf查Machine:字段，必须是EM_ARM - 用
arm-none-eabi-objdump -d your_project.elf | head -20看反汇编开头几行，指令应是movs、bl、bx等 ARM Thumb 指令，不是movq或callq（那是 x86） - 用
arm-none-eabi-size your_project.elf看各段尺寸：如果.data和.bss异常大（比如 >64KB），可能误把调试符号或未裁剪的库塞进去了
实际项目里最容易被忽略的，是启动文件和链接脚本的耦合关系——改了芯片型号，不仅要换 startup_*.s，还得同步更新 .ld 里的内存布局和入口符号名（比如 Reset_Handler 在不同 HAL 版本里可能叫 Default_Handler）。这两者一旦不匹配，程序连第一条指令都不会执行。
