新手避坑指南：STM32用Makefile编译时，遇到‘junk at end of line’错误怎么办？

STM32 Makefile编译实战：彻底解决'junk at end of line'汇编错误

第一次用Makefile编译STM32项目时，看到满屏的junk at end of line错误提示，确实容易让人头皮发麻。这就像你兴冲冲地下载了一个开源项目准备大展身手，结果刚执行make命令就被泼了一盆冷水——几十行红色错误信息不断滚动，而且全都指向一个神秘的startup_stm32f10x_hd.S文件。别担心，这其实是每个从Keil/IAR转向GCC工具链的开发者都会遇到的"成人礼"。本文将带你深入理解这个问题的根源，并提供两种不同层次的解决方案：快速修复方案适合急于让项目跑起来的场景；而深度解析方案则能让你彻底掌握不同工具链的汇编语法差异，避免未来再踩类似的坑。

1. 错误现象与快速诊断

当你在终端执行make命令后，典型的错误输出长这样：

startup_stm32f10x_hd.S:1: Error: junk at end of line, first unrecognized character is `*' startup_stm32f10x_hd.S:2: Error: junk at end of line, first unrecognized character is `*' ... startup_stm32f10x_hd.S:21: Error: bad instruction `the PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY...'

关键诊断要点：

1. 错误类型：所有错误都来自同一个汇编文件(.S后缀)
2. 错误模式：
   • 前20行左右都是junk at end of line，指向*字符
   • 后续出现bad instruction，指向大段英文文本
3. 文件来源：这个startup_stm32f10x_hd.S很可能是从Keil项目直接拿过来的

经验提示：如果你在开源项目中发现startup文件位于Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/keil这样的路径中，基本可以确定它是专为Keil优化的版本。

快速检查清单：

• [ ] 确认使用的启动文件是否来自Keil目录
• [ ] 检查文件开头是否包含大量*开头的注释块
• [ ] 查看是否有非汇编指令的英文段落

2. 问题根源：Keil与GCC的汇编语法差异

这个编译错误的本质在于不同工具链对汇编文件的解析规则不同。Keil的ARMCC编译器允许一些特殊的语法格式，而GCC的汇编器(as)则严格遵守GNU汇编规范。

2.1 Keil风格汇编的典型特征

观察一个典型的Keil版启动文件，开头通常是这样的：

;******************** (C) COPYRIGHT 2011 STMicroelectronics ******************** ;* File Name : startup_stm32f10x_hd.s ;* Author : MCD Application Team ;* Version : V3.5.0 ;* Date : 11-March-2011 ;* Description : STM32F10x High Density Devices vector table for MDK-ARM toolchain. ;* This module performs: ;* - Set the initial SP ;* - Set the initial PC == Reset_Handler ;* - Set the vector table entries with the exceptions ISR address ;* - Configure the clock system ;* - Branches to __main in the C library (which eventually ;* calls main()). ;* After Reset the Cortex-M3 processor is in Thread mode, ;* priority is Privileged, and the Stack is set to Main. ;*******************************************************************************

关键差异点：

2.2 为什么GCC会报错

GNU汇编器遇到*开头的行时，会尝试将其解析为：

1. 可能的乘法指令
2. 间接寻址符号
3. 其他合法操作符

当发现这些*后面跟着的既不是操作数也不是合法语法时，就会抛出junk at end of line错误。而后面那些大段英文文本因为没有用正确的注释符号包裹，被当作汇编指令解析，自然就产生了bad instruction错误。

3. 快速解决方案：获取GCC兼容的启动文件

对于急于让项目跑起来的开发者，最快捷的方法是获取官方提供的GCC版启动文件。

3.1 从STM32CubeMX/FW包获取

1. 通过STM32CubeMX生成：

   • 在Project Manager → Code Generator中勾选"Generate peripheral initialization as a pair of .c/.h files"
   • 确保Toolchain/IDE选择为"Makefile"

2. 从STM32CubeF1包直接获取： 正版启动文件通常位于：

   STM32Cube_FW_F1_Vx.x.x/Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/gcc/

   包含：

   • startup_stm32f103xe.s(对应高密度型号)
   • 其他密度等级的启动文件

3. 文件替换步骤：

   cp STM32Cube_FW_F1/Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/gcc/startup_stm32f103xe.s your_project/ mv your_project/startup_stm32f10x_hd.S your_project/startup_stm32f10x_hd.S.bak # 备份原文件

3.2 验证链接脚本和系统文件

即使换了启动文件，还可能遇到：

arm-none-eabi-ld: cannot open linker script file stm32_flash.ld: No such file or directory

解决方案：

1. 从CubeMX项目或Cube包中获取链接脚本：

   cp STM32Cube_FW_F1/Projects/STM32F103RB-Nucleo/Templates/SW4STM32/STM32F103RB-Nucleo/STM32F103RBTx_FLASH.ld your_project/stm32_flash.ld

2. 确保项目包含系统初始化文件：
   • system_stm32f10x.c
   • system_stm32f10x.h

实用技巧：在Makefile中添加查找路径：

LIBPATHS = -L$(STM32CUBE_DIR)/Drivers/CMSIS/Lib/GCC

4. 深度解决方案：手动转换Keil启动文件

如果你想深入理解汇编差异，或者不得不修改现有启动文件，可以按照以下步骤手动转换。

4.1 注释格式转换

原始Keil文件：

;****************************************************************************** ;* File Name : startup_stm32f10x_hd.s ;* Author : MCD Application Team ;* Version : V3.5.0 ;******************************************************************************

转换为GCC格式：

@****************************************************************************** @* File Name : startup_stm32f10x_hd.s @* Author : MCD Application Team @* Version : V3.5.0 @******************************************************************************

或者：

/* ****************************************************************************** * File Name : startup_stm32f10x_hd.s * Author : MCD Application Team * Version : V3.5.0 ****************************************************************************** */

4.2 伪指令转换对照表

常见需要修改的伪指令：

4.3 完整转换示例

转换前(Keil):

; Vector Table Mapped to Address 0 at Reset AREA RESET, DATA, READONLY EXPORT __Vectors EXPORT __Vectors_End EXPORT __Vectors_Size __Vectors DCD __initial_sp ; Top of Stack DCD Reset_Handler ; Reset Handler DCD NMI_Handler ; NMI Handler

转换后(GCC):

.section .isr_vector,"a",%progbits .global __Vectors .global __Vectors_End .global __Vectors_Size __Vectors: .word __initial_sp @ Top of Stack .word Reset_Handler @ Reset Handler .word NMI_Handler @ NMI Handler

4.4 常见问题修复

问题1：undefined reference to SystemInit

startup_stm32f103zetx.s:98: undefined reference to `SystemInit'

解决方案：

1. 确保项目包含system_stm32f10x.c文件
2. 在启动文件中确认有.extern SystemInit声明
3. 检查system_stm32f10x.h中的#define STM32F10X_HD是否正确

问题2：.syntax divided错误

Error: instruction not allowed in IT block -- `sub sp,#0x10'

修复方法： 在文件开头添加：

.syntax unified .thumb

5. 预防措施与最佳实践

为了避免将来再遇到类似问题，建议建立以下开发规范：

5.1 项目初始化检查清单

1. 工具链确认：

   • [ ] 明确使用GCC还是Keil/IAR
   • [ ] 获取对应版本的启动文件

2. 文件来源验证：

   file startup_stm32f10x_hd.s # 查看文件类型 head -n 20 startup_stm32f10x_hd.s # 检查文件头

3. Makefile配置检查：

   # 正确设置汇编器flags ASFLAGS = -mcpu=cortex-m3 -mthumb -Wall -fdata-sections -ffunction-sections

5.2 版本控制策略

建议在项目中保留不同工具链的启动文件：

project/ ├── startup/ │ ├── gcc/ │ │ └── startup_stm32f103xe.s │ └── keil/ │ └── startup_stm32f10x_hd.s ├── Makefile └── ...

在Makefile中动态选择：

ifeq ($(TOOLCHAIN),gcc) STARTUP_FILE = startup/gcc/startup_stm32f103xe.s else STARTUP_FILE = startup/keil/startup_stm32f10x_hd.s endif

5.3 自动化验证脚本

创建一个简单的验证脚本check_startup.sh：

#!/bin/bash # 检查启动文件是否包含Keil特有语法 if grep -qE '^\s*;|^\s*\*|^AREA|^DCD' $1; then echo "警告：文件可能包含Keil特有语法" exit 1 fi exit 0

添加到Makefile的预处理步骤：

pre-build: @./check_startup.sh $(STARTUP_FILE)

6. 进阶：理解启动文件的工作原理

要真正掌握启动过程，需要理解启动文件的关键组成部分：

6.1 中断向量表结构

典型的向量表定义：

__Vectors: .word __initial_sp /* 初始栈指针 */ .word Reset_Handler /* 复位中断 */ .word NMI_Handler /* NMI中断 */ .word HardFault_Handler /* 硬件错误中断 */ /* ...其他中断向量... */ __Vectors_End:

关键点：

• 第一个元素必须是初始栈指针
• 第二个元素是复位向量，指向程序入口
• 向量地址必须4字节对齐

6.2 复位处理流程

典型的Reset_Handler实现：

Reset_Handler: ldr sp, =_estack /* 设置栈指针 */ /* 复制.data段从Flash到RAM */ ldr r0, =_sidata ldr r1, =_sdata ldr r2, =_edata bl memory_copy /* 清零.bss段 */ ldr r0, =_sbss ldr r1, =_ebss bl zero_memory /* 调用库初始化 */ bl __libc_init_array /* 跳转到main */ bl main /* 如果main返回则进入死循环 */ b .

6.3 内存布局与链接脚本

典型的链接脚本片段(stm32_flash.ld)：

MEMORY { FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 512K RAM (xrw) : ORIGIN = 0x20000000, LENGTH = 64K } SECTIONS { .isr_vector : { . = ALIGN(4); KEEP(*(.isr_vector)) . = ALIGN(4); } >FLASH .text : { . = ALIGN(4); *(.text) *(.text*) /* ...其他段... */ } >FLASH }

掌握这些底层细节后，你就能真正理解启动过程，而不再只是机械地复制文件。当遇到类似junk at end of line这样的错误时，也能快速定位到问题的本质。