如何解决Windows命令行长度限制导致CMake固件构建失败问题？

问题背景 #

在Windows系统中使用CMake构建固件程序，通过GitBash执行Make命令生成Makefile时，遭遇Windows命令行8188字符长度限制——生成的Makefile超出该限制，导致构建失败。使用的交叉编译器为arm-none-eabi-gcc工具链，且必须在Windows环境下完成构建。

使用的CMake命令 #

cmake -DDFU_FILENAME=dfu.zip -DKEY_DIR=${HOME}/Downloads -DARM_NONE_EABI_PATH="/c/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/11.3 rel1/arm-none-eabi" -DSDK_ROOT_DIR=${HOME}/fatfs/stix_nrf_sdk -DVERSION=259 -DCMAKE_TOOLCHAIN_FILE="../stix_toolchain.cmake" -DCMAKE_C_COMPILER:FILEPATH="/c/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/11.3 rel1/bin/arm-none-eabi-gcc.exe" ..

错误信息 #

make 
[  0%] Building C object CMakeFiles/stix_fw.dir/main.c.obj 
arm-none-eabi-gcc.exe: error: unrecognized command-line option '-fstac'; did you mean '-fstats'? 
arm-none-eabi-gcc.exe: fatal error: no input files 
compilation terminated. 
make[2]: *** [CMakeFiles/stix_fw.dir/build.make:76: CMakeFiles/stix_fw.dir/main.c.obj] Error 1 
make[1]: *** [CMakeFiles/Makefile2:118: CMakeFiles/stix_fw.dir/all] Error 2 
make: *** [Makefile:91: all] Error 2

解决办法 #

• 启用CMake响应文件：CMake支持用响应文件（.rsp）传递过长参数，避免命令行截断。可在CMakeLists.txt中添加配置：

  set(CMAKE_C_USE_RESPONSE_FILE_FOR_OBJECTS 1)
  set(CMAKE_CXX_USE_RESPONSE_FILE_FOR_OBJECTS 1)
  

  或者在执行CMake时直接指定参数：

  cmake -DCMAKE_C_USE_RESPONSE_FILE_FOR_OBJECTS=1 -DCMAKE_CXX_USE_RESPONSE_FILE_FOR_OBJECTS=1 ... # 其他参数保持不变
  

• 缩短路径长度：

  • 将工具链、SDK等移到短路径目录，比如把/c/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/11.3 rel1改为/c/ArmToolchain，减少路径字符数。
  • 用环境变量替代长路径，比如设置export ARM_TOOLCHAIN=/c/ArmToolchain，然后CMake命令中使用-DARM_NONE_EABI_PATH=${ARM_TOOLCHAIN}/arm-none-eabi。

• 改用Ninja构建系统：Ninja对命令行长度的兼容性更好，不易触发Windows的字符限制。生成Ninja构建文件的命令：

  cmake -G Ninja -DDFU_FILENAME=dfu.zip -DKEY_DIR=${HOME}/Downloads -DARM_NONE_EABI_PATH="/c/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/11.3 rel1/arm-none-eabi" -DSDK_ROOT_DIR=${HOME}/fatfs/stix_nrf_sdk -DVERSION=259 -DCMAKE_TOOLCHAIN_FILE="../stix_toolchain.cmake" -DCMAKE_C_COMPILER:FILEPATH="/c/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/11.3 rel1/bin/arm-none-eabi-gcc.exe" ..
  

  之后执行ninja命令完成构建。

• 简化编译选项：检查CMakeLists.txt中是否存在重复、冗余的编译选项，合并或删除不必要的选项，减少命令行总字符数。

内容的提问来源于stack exchange，提问作者Gregory Tidanian