Linux GCC环境下CMake构建静态库时ar报错找不到-v文件如何解决

构建静态库时，GCC工具链使用ar归档工具生成.a静态库文件，而非调用链接器。你遇到报错的核心原因如下：

1. STATIC_LIBRARY_OPTIONS是CMake专门用于向静态库归档工具（此处为ar）传递参数的属性，而非配置链接器参数的属性。
2. GNU ar的命令格式为 ar [操作符+选项] 归档文件名 输入目标文件列表，所有短选项必须和操作符合并作为第一个参数，不能单独作为位置参数传入。你单独配置的-v会被CMake追加到ar命令的末尾，被ar识别为需要加入归档的输入文件名，因此触发-v: No such file or directory的报错。

• 如果你需要给ar归档工具传递全局参数（比如开启详细输出的v选项），推荐修改全局ar标志变量，选项直接追加到默认操作符后即可，不需要加-前缀：

  # 给所有静态库的ar命令增加v选项，开启详细输出
  set(CMAKE_AR_FLAGS "${CMAKE_AR_FLAGS} v")
  

• 如果你只需要给单个静态库的ar命令传参数，推荐使用长选项避免被识别为输入文件：

  set_target_properties(libMyExample PROPERTIES 
      STATIC_LIBRARY_OPTIONS --verbose
  )
  

• 如果你需要给链接该静态库的目标传递链接器参数，不要配置在静态库自身的属性上，使用target_link_options配置为INTERFACE可见性即可自动传递给依赖方：

  # 示例：给所有链接libMyExample的目标传递-O2链接优化参数
  target_link_options(libMyExample INTERFACE -O2)
  

• 如果你构建的是共享库或可执行文件，需要直接配置自身的链接器参数，使用target_link_options即可，不需要修改归档工具相关属性：

  # 示例：给共享库配置链接器参数
  add_library(MyShared SHARED ${SOURCES})
  target_link_options(MyShared PRIVATE -Wl,--as-needed)
  

• 额外注意：静态库本身只是目标文件的归档包，不存在链接过程，因此给静态库配置链接器参数是完全无效的，只有生成共享库、可执行文件时才需要配置链接器参数。

内容的提问来源于stack exchange，提问作者Hayk Poghosyan