4、条件判断与平台检测：ifeq/ifneq/ifdef的使用、检测操作系统类型、检测编译器类型

写跨平台 Makefile，说白了就是让同一份代码能在 Windows、Linux、macOS 上都能编译通过。

但不同平台差异太大了——路径分隔符不一样，编译器不一样，链接库的方式也不一样。

怎么办？靠条件判断。

Makefile 里没有 if-else 语句，但有 ifeq、ifneq、ifdef 这几个条件指令。用好了，一份 Makefile 就能通吃所有平台。

4.1 条件判断的基本语法

先看最简单的用法。条件判断必须成对出现，以 endif 结尾。

ifeq ($(OS), Linux)
    $(info "当前是 Linux 系统")
endif

这行代码的意思是：如果变量 OS 的值等于 Linux，就打印一条信息。

注意，ifeq 后面跟的是 括号 + 逗号 + 空格 的格式。我刚开始写的时候经常漏掉那个空格，结果条件死活不生效。后来养成了习惯：ifeq ($(A), $(B))，逗号后面一定加空格。

4.2 ifeq 与 ifneq：相等与不等

ifeq 判断相等，ifneq 判断不相等。两者用法完全一样。

ifeq ($(CC), gcc)
    CFLAGS += -Wall -Wextra
endif

ifneq ($(CROSS_COMPILE), )
    # 如果交叉编译前缀不为空，说明是交叉编译
    $(info "交叉编译模式: $(CROSS_COMPILE)")
endif

我在项目中遇到过一个问题：用 ifeq 判断字符串时，变量值前后不能有多余的空格。比如 ifeq ($(VAR), hello)，如果 VAR 的值是 " hello"（前面有个空格），条件就不成立。这个坑我踩过两次，后来每次都会在变量赋值时用 strip 函数清理一下。

4.3 ifdef 与 ifndef：变量是否定义

ifdef 检查变量是否被定义，ifndef 检查是否未定义。

ifdef DEBUG
    CFLAGS += -g -O0
    $(info "调试模式已开启")
else
    CFLAGS += -O2
endif

这里有个细节：ifdef 只检查变量是否被定义，不检查它的值是否为空。如果一个变量被定义为空字符串，ifdef 仍然认为它被定义了。

注意： ifdef 和 ifeq ($(VAR), ) 的行为不同。前者检查定义状态，后者检查值是否为空。我建议用 ifeq 来判断空值，语义更清晰。

4.4 检测操作系统类型

这是跨平台 Makefile 的核心。不同操作系统，编译选项、链接库、路径格式都不一样。

我常用的检测方式是这样的：

# 检测操作系统
UNAME_S := $(shell uname -s)

ifeq ($(UNAME_S), Linux)
    OS := linux
    LIB_SUFFIX := .so
    EXE_SUFFIX := 
    RM := rm -f
else ifeq ($(UNAME_S), Darwin)
    OS := macos
    LIB_SUFFIX := .dylib
    EXE_SUFFIX := 
    RM := rm -f
else ifeq ($(UNAME_S), Windows_NT)
    OS := windows
    LIB_SUFFIX := .dll
    EXE_SUFFIX := .exe
    RM := del /q
else
    $(error "不支持的操作系统: $(UNAME_S)")
endif

为什么用 uname -s？因为它在 Linux 和 macOS 上都可用。Windows 下如果没有 MSYS 或 Cygwin，uname 可能不存在。这时候可以用环境变量 OS 来判断：

# Windows 下备用方案
ifdef OS
    ifeq ($(OS), Windows_NT)
        OS_TYPE := windows
    endif
endif

我个人习惯把操作系统检测放在 Makefile 的最前面，这样后面的所有规则都能用到 OS 这个变量。

4.5 检测编译器类型

操作系统搞定了，编译器也得区分。GCC、Clang、MSVC 的选项差异很大。

# 检测编译器
ifeq ($(CC), gcc)
    COMPILER := gcc
    CFLAGS += -std=gnu11
else ifeq ($(CC), clang)
    COMPILER := clang
    CFLAGS += -std=c11
else ifeq ($(CC), cl)
    COMPILER := msvc
    CFLAGS += /std:c11
else
    $(warning "未知编译器: $(CC)，使用默认设置")
endif

但有时候 CC 变量可能包含路径，比如 /usr/bin/gcc。这时候用 notdir 函数提取文件名：

CC_NAME := $(notdir $(CC))

ifeq ($(CC_NAME), gcc)
    $(info "检测到 GCC 编译器")
else ifeq ($(CC_NAME), clang)
    $(info "检测到 Clang 编译器")
endif

我曾经在一个项目里遇到这种情况：开发机上是 GCC，CI 环境里是 Clang。因为没做编译器检测，GCC 特有的 -Wno-unused-result 选项在 Clang 下报错。后来我加上了编译器检测，不同编译器用不同的警告选项，问题就解决了。

4.6 组合判断：平台 + 编译器

实际项目中，经常需要同时判断操作系统和编译器。比如在 Linux 上用 GCC，在 macOS 上用 Clang：

# Linux + GCC 的特殊优化
ifeq ($(OS), linux)
    ifeq ($(COMPILER), gcc)
        CFLAGS += -march=native -flto
    endif
endif

# macOS + Clang 的特殊处理
ifeq ($(OS), macos)
    ifeq ($(COMPILER), clang)
        CFLAGS += -mmacosx-version-min=10.14
    endif
endif

嵌套条件判断时，缩进一定要清晰。我见过有人把 endif 写错位置，导致整个 Makefile 逻辑混乱。我的建议是：每个 ifeq 后面都写上注释，标明结束的是哪个条件。

ifeq ($(OS), linux)      # 开始：Linux 检测
    ifeq ($(COMPILER), gcc)  # 开始：GCC 检测
        CFLAGS += -flto
    endif                    # 结束：GCC 检测
endif                        # 结束：Linux 检测

4.7 实战：一个完整的平台检测框架

把上面这些知识点串起来，就是一个可复用的平台检测模块：

# ============================================
# 平台检测模块
# ============================================

# 1. 检测操作系统
UNAME_S := $(shell uname -s 2>/dev/null || echo unknown)

ifeq ($(UNAME_S), Linux)
    PLATFORM_OS := linux
    PLATFORM_PATH_SEP := /
    PLATFORM_EXE := 
else ifeq ($(UNAME_S), Darwin)
    PLATFORM_OS := macos
    PLATFORM_PATH_SEP := /
    PLATFORM_EXE := 
else ifneq ($(findstring Windows, $(UNAME_S)), )
    PLATFORM_OS := windows
    PLATFORM_PATH_SEP := \\
    PLATFORM_EXE := .exe
else
    PLATFORM_OS := unknown
endif

# 2. 检测编译器
CC_NAME := $(notdir $(CC))

ifneq ($(findstring gcc, $(CC_NAME)), )
    PLATFORM_CC := gcc
else ifneq ($(findstring clang, $(CC_NAME)), )
    PLATFORM_CC := clang
else ifneq ($(findstring cl, $(CC_NAME)), )
    PLATFORM_CC := msvc
else
    PLATFORM_CC := unknown
endif

# 3. 根据平台设置编译选项
ifeq ($(PLATFORM_OS), linux)
    ifeq ($(PLATFORM_CC), gcc)
        CFLAGS += -D_GNU_SOURCE
    endif
else ifeq ($(PLATFORM_OS), macos)
    CFLAGS += -D_DARWIN_C_SOURCE
else ifeq ($(PLATFORM_OS), windows)
    CFLAGS += -D_WIN32_WINNT=0x0601
endif

$(info "平台: $(PLATFORM_OS), 编译器: $(PLATFORM_CC)")
小技巧： 用 $(info ...) 打印检测结果，方便调试。如果检测结果不对，先看看 uname -s 的输出是什么，再调整匹配规则。

4.8 知识体系图

下面这张图展示了条件判断与平台检测的核心逻辑：

条件判断与平台检测知识体系 条件判断指令 ifeq / ifneq ifdef / ifndef else / endif 应用场景 检测操作系统 Linux / macOS / Windows 检测编译器 GCC / Clang / MSVC 组合判断 平台 + 编译器 + 选项 输出：平台变量 + 编译器变量 + 编译选项 核心思路：先检测，后设置，再编译

4.9 避坑指南

最后分享几个我踩过的坑：

  • 变量名大小写：Makefile 变量名区分大小写。OS 和 os 是两个不同的变量。我习惯全部大写，一眼就能看出是全局变量。
  • 空格问题：ifeq ($(A), $(B)) 中逗号后面必须有一个空格。少了空格，Make 会报语法错误。
  • 条件嵌套：嵌套不要超过三层，否则可读性会急剧下降。如果逻辑复杂，考虑拆分成多个小模块。
  • 跨平台测试：写完平台检测后，一定要在目标平台上实际跑一遍。我曾经在 macOS 上写好的检测，放到 Linux 上就失效了，原因是 uname -s 的输出格式不同。

核心原则： 条件判断的目的是让 Makefile 自适应，而不是让 Makefile 变得复杂。能用简单条件解决的问题，不要用嵌套。能用变量解决的问题，不要用条件。

嗯，条件判断和平台检测就讲到这里。这些技巧我在实际项目中反复使用，确实能省下不少跨平台适配的时间。你写 Makefile 的时候，不妨先从检测操作系统和编译器开始，一步步把条件判断加进去。

← 上一章 📖 返回目录 下一章 →