深入探析makefile missing separator

EMBYG • 2025-02-01 13:34 • 编程

一、错误的解释

在Linux下，编译时常见的错误信息之一就是makefile missing separator，该错误信息常被误解为缺失了分隔符，导致编译错误。

实际上，这个错误信息的本质含义是出现了无效的字符和格式错误。检查错误时，我们应该仔细检查每个行的开头是否有缩进，是否有非法字符等问题。

二、使用Tab而不是空格缩进

makefile中，使用tab键而不是空格来进行缩进是一个编写良好的makefile的基本规范。因为makefile是一个使用Makefile语法的配置文件，Makefile语法对于缩进很敏感。TAB键和空格的区别：

    foo : bar
        echo "hello world"

注意，行的开头有一个TAB字符，如果将TAB替换为四个空格，就会出现“missing separator”错误。这是因为GNU Make工具不能识别空格缩进格式。

三、检查编码格式

编码格式也可能会引起“missing separator”错误。因为makefile需要以UNIX格式编写，所以如果您在Windows平台上创建了一个makefile，并在不转换其格式的情况下将其移植到Linux上，则可能因为编码格式不同而导致此错误。

检查makefile的编码格式，常见的有UTF-8和GBK等。使用vim命令可以轻松地查看文件编码格式，命令如下：

    vim file_name
    :set fileencoding

如果你发现makefile的编码格式不同，请考虑将其转换为正确的格式。Windows下的notepad++工具可以方便地将文件编码格式转换为UNIX格式，而在Linux下，iconv命令可以用于转换文件编码格式：

    iconv -t utf8 -f gb2312 -o output_file input_file

四、检查环境变量

makefile在执行时，会依赖一些环境变量来完成编译工作，如果环境变量配置有误或者缺失，也会导致“missing separator”错误。

在编写makefile时，请确保检查需要使用的环境变量是否正确配置，以及makefile是否使用了正确的环境变量名。

五、使用额外的工具

如果您遇到复杂的“missing separator”错误，可以考虑使用一些额外的工具来帮助您分析问题。

例如，您可以使用lindent工具来检查makefile的代码，并自动修复缩进格式错误。

    sudo apt install lindent
    lindent my_makefile

完整的makefile示例

下面是一个包含多个目录和文件的简单的Makefile文件。

    # Makefile

    SRCS := src/main.c src/foo.c src/bar.c
    OBJS := $(SRCS:.c=.o)
    INCLUDES := -I./src/include
    CFLAGS := -Wall -O2 $(INCLUDES)
    LFLAGS := -lm

    BINDIR := bin
    TARGET := $(BINDIR)/myprog

    .PHONY : clean

    all : $(TARGET)

    $(TARGET) : $(OBJS) | $(BINDIR)
        gcc $(OBJS) $(LFLAGS) -o $@

    $(BINDIR) :
        mkdir $(BINDIR)

    %.o : %.c
        gcc $(CFLAGS) -c $< -o $@

    clean :
        rm -rf $(BINDIR) $(OBJS)

在这个示例Makefile中，我们添加了注释来需要展示编写了注释的好习惯。

同时，我们使用了.include目标来添加包含目录，使用Wall选项启用所有警告，以及O2选项启用编译优化。

对于“missing separator”错误，我们要注意缩进使用了TAB键而不是空格，并且代码使用了Unix编码格式。

另外，为了快速清理编译生成的文件，我们添加了clean规则、all目标等。

原创文章，作者：EMBYG，如若转载，请注明出处：https://www.506064.com/n/333578.html