Makefile命令行开头必须为ASCII 0x09(Tab),不可用空格、soft tab或BOM;报错行即首个非Tab命令所在行,可用cat -t验证^I,手动删除空格后按Tab键修复。

Makefile 里命令行开头必须是 Tab,不是空格,也不是 4 个空格 —— 这是唯一能过 make 解析的分隔符。
为什么 missing separator 错误总在第 N 行报出?
因为 make 在解析规则时,只认一种“动作起始标记”:ASCII 0x09(Tab)。它不接受空格、全角冒号、BOM 头、UTF-8 编码里的不可见字符,也不认编辑器自动插入的 soft tab。一旦某条命令(比如 gcc、rm、cp)前面是空格,哪怕只有 1 个,make 就直接报 missing separator. Stop. 并退出。
常见触发点:
-
clean:后面那行rm -f *.o没加 Tab - 复制粘贴网上 Makefile 示例,结果把空格当 Tab 用了
- VS Code / Vim / Sublime 默认把 Tab 转成 4 个空格(
expandtab开启) - 用 Windows 记事本保存,带 BOM 的 UTF-8 文件头被
make当作乱码处理
怎么确认是不是 Tab 问题?
别靠肉眼猜。用终端命令直接看隐藏字符:
cat -e -t -v Makefile
输出中:
-
^I表示真实 Tab(✅ 正确) -
(一串空格)表示空格(❌ 错误) -
M-oM-?M-?或开头有efbb bf字样,说明文件带 BOM(❌ 需重存为 UTF-8 without BOM 或 ASCII)
重点检查报错行(如 Makefile:4)及其上一行的冒号 : 后是否紧跟着 ^I。
怎么改才保险?
手动修复比依赖编辑器设置更可靠:
- 删掉命令行开头所有空格,按一次 Tab 键(不是空格键)
- 避免在
Makefile中写\rm—— 改成rm,前面加 Tab - 变量赋值行(如
CC = gcc)、条件判断(如ifeq)、注释(#开头)都不能以 Tab 开头,否则会被当成命令执行 - 如果用 Vim,临时关掉空格替换:
:set noexpandtab;VS Code 在右下角状态栏点击 “Spaces: 4”,选 “Indent Using Tabs”
还有可能是环境或路径问题?
极少数情况(尤其是 Symbian/GCCE 旧工具链),missing separator 是假象 —— 真实原因是 make 在解析某条自动生成的路径时失败,比如:
-
arm-none-symbianelf-g++不在$PATH中,导致cl_bpabi.pm生成的行缺内容 - Makefile 里调用了 shell 命令(如
$(shell which gcc)),但该命令执行失败返回空,造成语法断裂
这时先运行 make -d 看详细解析过程,或临时把可疑行注释掉,再逐行放开验证。
真正麻烦的不是改 Tab,而是有些编辑器会悄悄把已有的 Tab 又转回空格 —— 每次保存前,记得再 cat -t 看一眼。


















