MacOS下LLVM 17编译时-unwindlib=libunwind参数未被使用警告排查

在MacOS上安装LLVM 17后，设置了以下环境变量以替代原生Apple Clang：

PATH="/opt/homebrew/opt/llvm/bin:$PATH"
LDFLAGS="-L/opt/homebrew/opt/llvm/lib -L/opt/homebrew/opt/llvm/lib/c++ -fuse-ld=lld -rtlib=compiler-rt -unwindlib=libunwind -Wl,-rpath,/opt/homebrew/opt/llvm/lib/c++"
CPPFLAGS="-I/opt/homebrew/opt/llvm/include"

配置CMake项目后，build.ninja中目标的相关内容如下：

# Link the executable <...>
  FLAGS = -g -arch arm64 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.2.sdk
  LINK_FLAGS = -L/opt/homebrew/opt/llvm/lib -L/opt/homebrew/opt/llvm/lib/c++ -fuse-ld=lld -rtlib=compiler-rt -unwindlib=libunwind -Wl,-rpath,/opt/homebrew/opt/llvm/lib/c++

对应的rules.ninja规则：

# Rule for linking CXX executable.
rule CXX_EXECUTABLE_LINKER__<...>
  command = $PRE_LINK && /opt/homebrew/opt/ccache/libexec/clang++ $FLAGS -Wl,-search_paths_first -Wl,-headerpad_max_install_names $LINK_FLAGS $in -o $TARGET_FILE $LINK_PATH $LINK_LIBRARIES && $POST_BUILD
  description = Linking CXX executable $TARGET_FILE
  restat = $RESTAT

构建时出现如下警告：

[61/395  12% :: 11.894] Linking CXX executable <...>
clang++: warning: argument unused during compilation: '-unwindlib=libunwind' [-Wunused-command-line-argument]

确认-unwindlib=libunwind是在链接阶段传递的，却触发了这个警告，原因是什么？

原因 #

-unwindlib=libunwind是Clang编译阶段的参数，而非链接阶段参数。即使你把它放在LDFLAGS中，链接时通过clang++调用链接器，Clang会先解析所有传入的参数：

• 编译阶段参数会被Clang本身处理，用于控制生成目标文件时的 unwind 库选择逻辑；
• 链接阶段参数通常需要通过-Wl,xxx前缀传递给链接器，或者是链接器直接支持的参数。

由于-unwindlib不属于链接阶段的有效参数，Clang在链接流程中无法识别并使用它，因此抛出“参数未被使用”的警告。

解决方法 #

将-unwindlib=libunwind从LDFLAGS转移到CPPFLAGS或CXXFLAGS环境变量中：

# 修改后的环境变量示例
PATH="/opt/homebrew/opt/llvm/bin:$PATH"
CXXFLAGS="-unwindlib=libunwind"
LDFLAGS="-L/opt/homebrew/opt/llvm/lib -L/opt/homebrew/opt/llvm/lib/c++ -fuse-ld=lld -rtlib=compiler-rt -Wl,-rpath,/opt/homebrew/opt/llvm/lib/c++"
CPPFLAGS="-I/opt/homebrew/opt/llvm/include"

这样参数会在编译阶段被Clang正确处理，控制目标文件生成时使用指定的 unwind 库，链接阶段就不会再出现未使用参数的警告。

内容的提问来源于stack exchange，提问作者Alex O