⚔️ Nimmake vs CMake — 嵌入式构建工具全面对比

⚔️ Nimmake vs CMake — 嵌入式构建工具全面对比CMake 是通用构建系统的行业标准Nimmake 是专为嵌入式 MCU 打造的现代替代方案。当你的项目是 ARM/RISC-V 固件而非桌面应用时选择可能比你想象的更简单。 一句话概括工具本质设计哲学CMake跨平台构建系统生成器meta-build编写 CMakeLists.txt → 生成 Makefile/Ninja → 编译Nimmake嵌入式专用构建系统编写 Python → 直接编译零中间步骤 核心差异总览对比维度CMakeNimmake语言自定义 DSLcmake语法纯 Python Nimmake学习曲线⭐⭐⭐ 中高DSL 多阶段模型⭐ 低会 Python 就会用 Nimmake芯片预设❌ 需要手写set(MCU cortex-m4)等✅内置 ARM/RISC-V 预设一行搞定 Nimmake厂商型号支持❌ 无✅VENDOR_MODEL_OF(Vendor.ST, STM32F407) Nimmake源码管理aux_source_directory()或手写列表Party 系统目录级自动扫描 Nimmake头文件路径target_include_directories()手动添加自动推导按 Party 自动包含 Nimmake宏定义target_compile_definitions()手动添加声明式传入自动注入 Nimmake依赖管理target_link_libraries()链接级DependOn()编译级自动排序 Nimmake多工具链切换工具链文件Toolchain file较复杂一键切换更新 3 行配置 NimmakeRISC-V 支持需手写-marchrv32imac等内置RISCV_32_IMAC_CFG开箱即用 Nimmake增量编译依赖后端Make/Ninja内置增量 命令哈希 头文件追踪 Nimmake构建缓存❌ 不自带需 ccache 等外部工具✅内置--cache NimmakeNinja 后端✅ 支持-G Ninja✅ 支持-n/--ninja平手编译数据库✅ 支持CMAKE_EXPORT_COMPILE_COMMANDS✅ 支持--compiledb平手第三方库集成FetchContent/find_package较复杂内置 FreeRTOS/LVGL/FatFS 等一行third_partyFREERTOS NimmakeIDE 集成极强VS、CLion、Qt Creator 官方支持compile_commands.json VS Code CMake大型项目管理极强数万源文件、复杂依赖中专注嵌入式单芯片项目 CMake桌面/服务端应用行业标准❌ 不支持纯嵌入式 CMake构建步骤配置 → 生成 → 构建三步一步到位 Nimmake跨平台✅ Windows/Linux/macOS✅ Windows/Linux/macOS平手 实战对比STM32F407 完整项目让我们用同一个 STM32F407 HAL 库 FreeRTOS 项目分别用 CMake 和 Nimmake 实现。项目结构STM32_Project/ ├── Core/ │ ├── main.c │ ├── stm32f4xx_it.c │ └── system_stm32f4xx.c ├── Drivers/ │ ├── Inc/ │ └── Src/ (20 HAL 源文件) ├── FreeRTOS/ │ ├── include/ │ ├── portable/ │ └── src/ ├── startup_stm32f407xx.s └── STM32F407XX_FLASH.ld CMake 实现~100 行cmake_minimum_required(VERSION 3.20) project(STM32F407 LANGUAGES C ASM) # ---- 芯片参数手动查手册 ---- set(MCU_FAMILY STM32F407xx) set(CPU cortex-m4) set(FPU fpv4-sp-d16) set(FLOAT_ABI hard) # ---- 工具链设置 ---- set(TOOLCHAIN_PREFIX arm-none-eabi-) set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}gcc) set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}g) set(CMAKE_ASM_COMPILER ${TOOLCHAIN_PREFIX}gcc) set(CMAKE_AR ${TOOLCHAIN_PREFIX}ar) set(CMAKE_OBJCOPY ${TOOLCHAIN_PREFIX}objcopy) set(CMAKE_SIZE ${TOOLCHAIN_PREFIX}size) # ---- 编译参数逐个手动写 ---- set(COMMON_FLAGS -mcpu${CPU} -mfpu${FPU} -mfloat-abi${FLOAT_ABI} -mthumb -O2 -g -Wall -fdata-sections -ffunction-sections ) set(CMAKE_C_FLAGS ${CMAKE_C_FLAGS} ${COMMON_FLAGS} -stdgnu99) set(CMAKE_ASM_FLAGS ${CMAKE_ASM_FLAGS} ${COMMON_FLAGS}) # ---- 链接参数 ---- set(LINKER_FLAGS ${COMMON_FLAGS} -nostartfiles -Wl,--gc-sections -T${CMAKE_SOURCE_DIR}/STM32F407XX_FLASH.ld -lm -lc -lgcc ) # ---- 头文件路径手动添加每个路径 ---- target_include_directories(${PROJECT_NAME} PRIVATE Core/Inc Drivers/Inc FreeRTOS/include FreeRTOS/portable/GCC/ARM_CM4F ) # ---- 宏定义手动添加 ---- target_compile_definitions(${PROJECT_NAME} PRIVATE ${MCU_FAMILY} USE_HAL_DRIVER ) # ---- 源文件手动列每个文件 ---- set(CORE_SRCS Core/main.c Core/stm32f4xx_it.c Core/system_stm32f4xx.c ) file(GLOB DRV_SRCS Drivers/Src/*.c) # GLOB 不自动更新 set(FREERTOS_SRCS FreeRTOS/src/list.c FreeRTOS/src/queue.c FreeRTOS/src/tasks.c FreeRTOS/src/timers.c FreeRTOS/portable/GCC/ARM_CM4F/port.c FreeRTOS/portable/MemMang/heap_4.c ) set(ASM_SRCS startup_stm32f407xx.s) # ---- 构建目标 ---- add_executable(${PROJECT_NAME} ${CORE_SRCS} ${DRV_SRCS} ${FREERTOS_SRCS} ${ASM_SRCS} ) target_link_options(${PROJECT_NAME} PRIVATE ${LINKER_FLAGS}) # ---- 自定义命令生成 bin/hex ---- add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD COMMAND ${CMAKE_OBJCOPY} -O binary ${PROJECT_NAME}.elf ${PROJECT_NAME}.bin COMMAND ${CMAKE_OBJCOPY} -O ihex ${PROJECT_NAME}.elf ${PROJECT_NAME}.hex ) # ---- 自定义目标烧录 ---- add_custom_target(flash COMMAND openocd -f interface/cmsis-dap.cfg -f target/stm32f4x.cfg -c program ${PROJECT_NAME}.elf verify reset exit ) Nimmake 实现~40 行fromnimmake.datasetsimportCORTEX_M4_CFGfromnimmake.HelperimportBuildType,Helper# ★ 工具链TOOLCHAIN{TOOLPATH:rD:\LLVM\arm-none-eabi-gcc14\bin,TOOL:gcc,TOOL_PREFIX:arm-none-eabi-,}hlpHelper()# ★ 芯片配置自动生成所有 -mcpu/-mfpu/-mthumb 参数CFGCORTEX_M4_CFG.clone()CFG.set(model,STM32F407)hlp.Config(CFG)hlp.set_cfg(linkscript,STM32F407XX_FLASH.ld)hlp.set_cfg(std_c,gnu99)# ★ 工具链hlp.Update(TOOLCHAIN)hlp.Refresh()# ★ Party 模块按目录自动扫描源码corehlp.Parties(CORE,Core)driverhlp.Parties(Driver,Drivers,third_partyHAL,defines{STM32F407xx:,USE_HAL_DRIVER:},)freertoshlp.Parties(FREERTOS,FreeRTOS,third_partyFREERTOS,# ← 内置 FreeRTOS 配置include_macros{chip:ARM_CM4F,heap:4},)# ★ 依赖关系core.DependOn([driver,freertos])driver.DependOn([core,freertos])freertos.DependOn([core])# ★ 构建目标srcs[startup_stm32f407xx.s]thlp.Program(test,sourcessrcs)hlp.DefaultTarget(t)# ★ 烧录命令hlp.Command(FLASH,[openocd -f interface/cmsis-dap.cfg -f target/stm32f4x.cfg -c \program build/test.elf verify reset exit\])hlp.Phony(flash,[FLASH]) 构建流程对比CMake三步走# Step 1: 配置Configure— 生成构建系统cmake-Bbuild-GNinja\-DCMAKE_TOOLCHAIN_FILEarm-gcc.cmake\-DCMAKE_BUILD_TYPERelease# Step 2: 构建Build— 执行编译cmake--buildbuild# Step 3: 烧录需要额外的自定义 targetcmake--buildbuild--targetflash问题配置阶段耗时大型项目可能 10-30 秒工具链文件需要额外维护配置错误要到构建阶段才能发现Nimmake一步到位# 直接编译无需配置阶段nimmake# 烧录nimm- **零配置开销**Python 文件直接执行 - 工具链检测在Refresh()时立即报错 - 编译参数在脚本中一目了然时立即报错 - 编译参数在脚本中清晰可见 ---## 关键特性深度对比### 1️⃣ 芯片配置cmake# CMake — 每个参数手动写容易遗漏set(CPU cortex-m4)set(FPU fpv4-sp-d16)set(FLOAT_ABI hard)# 忘了加 -mthumb → 链接报错排查半天# Nimmake — 内置预设一行搞定CFGCORTEX_M4_CFG.clone()# 自动生成: -mcpucortex-m4 -mfpufpv4-sp-d16 -mflo- **零配置开销**Python 文件直接执行-工具链检测在 Refresh() 时立即报错-编译参数在脚本中一目了然thumb2️⃣ 工具链切换# CMake — 需要额外维护工具链文件 # arm-gcc.cmake set(CMAKE_C_COMPILER arm-none-eabi-gcc) set(CMAKE_CXX_COMPILER arm-none-eabi-g) set(CMAKE_ASM_COMPILER arm-none-eabi-gcc) set(CMAKE_AR arm-none-eabi-ar) set(CMAKE_OBJCOPY arm-none-eabi-objcopy) # 构建时通过 -DCMAKE_TOOLCHAIN_FILE 传入 cmake -B build -DCMAKE_TOOLCHAIN_FILEarm-gcc.cmake# Nimmake — 字典直接配置hlp.Update({TOOLPATH:rD:\LLVM\arm-none-eabi-gcc14\bin,TOOL:gcc,TOOL_PREFIX:arm-none-eabi-,})# 换 RISC-V改三行hlp.Update({TOOLPATH:rD:\LLVM\xpack-riscv-none-elf-gcc-15\bin,TOOL:gcc,TOOL_PREFIX:riscv-none-elf-,})3️⃣ 第三方库集成# CMake — 集成 FreeRTOS 需要 # 1. 下载/添加源码 # 2. 手动列出所有源文件至少 6 个 # 3. 手动添加 4 个头文件路径 # 4. 手动添加宏定义 # 5. 处理 portable 层路径 # 或者用 FetchContent也很复杂 include(FetchContent) FetchContent_Declare( freertos GIT_REPOSITORY https://github.com/FreeRTOS/FreeRTOS.git GIT_TAG V10.5.1 ) # ... 然后还是要手动配置源文件列表和头文件路径# Nimmake — 一行搞定freertoshlp.Parties(FREERTOS,FreeRTOS,third_partyFREERTOS,include_macros{chip:ARM_CM4F,heap:4},)# 内置 FreeRTOS 配置自动处理所有细节# ✅ 自动选择 portable/GCC/ARM_CM4F 层# ✅ 自动添加 include 路径# ✅ 自动添加源文件# ✅ 自动选择堆管理方案heap_4.c内置的第三方库支持库CMake 集成难度Nimmake 集成FreeRTOS⭐⭐⭐ 手动⭐third_partyFREERTOSLVGL⭐⭐⭐ 手动⭐third_partyLVGLFatFS⭐⭐⭐ 手动⭐third_partyFATFSCherryUSB⭐⭐⭐ 手动⭐third_partyCHERRYUSBFreeModbus⭐⭐⭐ 手动⭐third_partyFREEMODBUSHAL Drivers⭐⭐ 半自动⭐third_partyHAL4️⃣ 编译数据库生成# CMakecmake-Bbuild-DCMAKE_EXPORT_COMPILE_COMMANDSON# 生成 build/compile_commands.json# 需要额外的配置参数记忆# Nimmakenimmake--compiledb# 直接生成 compile_commands.json5️⃣ 缓存加速# CMake — 需要外部工具# 安装 ccachesudoaptinstallccache# 设置 cmakecmake-Bbuild-DCMAKE_C_COMPILER_LAUNCHERccache# 跨平台配置不一致Windows 下麻烦# Nimmake — 内建nimmake--cache# 首次编译nimmake--cache# 二次编译缓存命中 适用场景建议选 CMake 的场景✅桌面/服务端应用Linux/Windows/macOS GUI 程序✅大型项目百万行代码、数百个模块✅复杂依赖管理需要find_package、FetchContent✅需要支持多种 IDEVS、CLion、Qt Creator 官方支持✅团队已熟练掌握 CMake✅需要同时构建嵌入式 主机测试程序选 Nimmake 的场景ARM / RISC-V MCU 固件开发多芯片/多平台嵌入式项目快速切换架构快速原型验证几分钟搭好编译环境项目依赖 FreeRTOS/LVGL 等第三方库团队不熟悉 CMake 但熟悉 PythonCI/CD 嵌入式流水线命令行驱动自| 维度 | CMake | Nimmake || ---------------------- | ------------------------- | ------------------------------ ||MCU 专精程度| ⭐⭐ 通用工具需手动适配 | ⭐⭐⭐⭐⭐ 为嵌入式而生 ||上手速度| ⭐⭐ 学习曲线陡峭 | ⭐⭐⭐⭐⭐ 会 Python 即可上手 ||第三方库集成| ⭐⭐ 灵活但繁琐 | ⭐⭐⭐⭐⭐ 开箱即用 ||多芯片切换| ⭐⭐ 工具链文件 参数 | ⭐⭐⭐⭐⭐ 改几行配置 ||大型项目管理| ⭐⭐⭐⭐⭐ 行业标准 | ⭐⭐ 适合中小型项目 ||桌面应用| ⭐⭐⭐⭐⭐ 行业标准 | ❌ 不支持 ||IDE 集成| ⭐⭐⭐⭐⭐ 官方支持 | ⭐⭐⭐⭐ compile_commands.json ||构建速度| ⭐⭐⭐⭐ 依赖 Ninja | ⭐⭐⭐⭐⭐ 内置缓存加速 ||代码量MCU 项目| 80-150 行 | 30-50 行 ||代码可读性| ⭐⭐⭐ DSL 语法 | ⭐⭐⭐⭐⭐ 纯 Python | | ⭐⭐⭐⭐⭐ 纯 P **CMake 是一个通用构建系统的瑞士军刀CMake 是一个通用构建系统的瑞士军刀——无所不能但为嵌入式 MCU 项目配置它常常大材小用。**Nimmake 是一把专门为嵌入式打造的手术刀——功能聚焦一刀精准。造的 surgical blade——功能聚焦一刀精准。选择建议你的项目是桌面/服务端应用 → CMake ✅ 你的项目是嵌入式 LinuxYocto/Buildroot → CMake ✅ 你的项目超过 50 个模块需要精细管理 → CMake ✅ 你的团队已经深度绑定 CLion/Qt Creator → CMake ✅ 你的项目是 ARM/RISC-V MCU 固件 → Nimmake 你需要快速切换多种芯片 → Nimmake 你集成了 FreeRTOS/LVGL 等库 → Nimmake 你希望构建脚本简洁可读 → Nimmake 立即体验 Nimmake# 安装pipinstallnimmake# 查看示例gitclone https://github.com/pophu/nimmake.gitcdnimmake/samples/05_arm32# 一键编译对比 cmake -B build cmake --build- [Nimmake GitHub](https://github.com/pophu/nimmake)-[Nimmake PyPI](https://pypi.org/project/nimmake/)-[Nimmake vs Makefile 对比](./nimmake_vs_makefile.md)-[示例ARM 项目](file:///d:/MyCodeNew/nimmake/samples/05_arm32/Nimmake.py)-[示例RISC-V 项目](file:///d:/MyCodeNew/nimmake/samples/07_riscv32/Nimmake.py)-[示例厂商型号自动配置](file:///d:/MyCodeNew/nimmake/samples/60_vendor_model/Nimmake.py)/samples/60_vendor_model/Nimmake.py)