Meson+Ninja构建时，cxxopts.hpp引发诡异stray错误该如何解决？

我正在开发一个项目，使用cxxopts.hpp解析命令行选项。引入该头文件后出现可复现的构建错误，具体步骤如下：

• 执行以下命令构建项目：

  meson build
  cd build
  ninja
  

• 首次构建无任何错误；
• 修改除test/vector.cpp和test/random.cpp（这两个文件中使用了cxxopts.hpp）之外的文件，执行ninja可正常构建；
• 但修改test/vector.cpp或test/random.cpp后执行ninja，会触发如下错误：

  [1/4] Compiling C++ object test/random.p/random.cpp.o
  FAILED: test/random.p/random.cpp.o
  c++ -Itest/random.p -Itest -I../test -I../include -fdiagnostics-color=always -D_FILE_OFFSET_BITS=64 -Wall -Winvalid-pch -Wnon-virtual-dtor -Wextra -Wpedantic -O0 -g -MD -MQ test/random.p/random.cpp.o -MF test/random.p/random.cpp.o.d -o test/random.p/random.cpp.o -c ../test/random.cpp
  In file included from ../include/cxxopts.hpp:43,
                   from ../test/random.cpp:6:
  test/vector:1:1: error: stray ‘\177’ in program
      1 | <U+007F>ELF<U+0002><U+0001><U+0001><U+0003><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0003><U+0000>><U+0000><U+0001><U+0000><U+0000><U+0000> F<U+0000><U+0000><U+0000><U+0000><U+0000><U+0000>@<U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><90><91><U+0015><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000>@<U+0000>8<U+0000><U+000D><U+0000>@<U+0000>(<U+0000>'<U+0000><U+0006><U+0000><U+0000><U+0000><U+0004><U+0000><U+0000><U+0000>@<U+0000><U+0000><U+0000><U+0000><U+0000><U+0000><U+0000>@<U+0000><U+0000><U+0000><U+0000>...
      (a very lengthy error up to 400 MB in a file)
  

错误本质是文件路径优先级冲突：

• cxxopts.hpp内部会包含标准库的<vector>头文件；
• 首次构建后，test目录下生成了名为vector的可执行文件；
• 编译器的包含路径参数中，-Itest排在-I../include和系统标准库路径之前，导致编译器尝试读取test/vector这个二进制可执行文件作为<vector>头文件解析，自然会出现乱码格式错误。

提供三种有效的解决思路：

1. 调整包含路径顺序：修改meson构建配置，确保项目头文件目录和系统标准库路径的优先级高于test目录。比如在meson.build中，将include_directories('../include')放在include_directories('test')之前，或者移除不必要的-Itest参数。
2. 重命名可执行文件：把test/vector可执行文件改名为vector_test或其他不与标准库头文件重名的名称，从根源上避免冲突。
3. 隔离构建产物：在meson配置中指定构建产物输出到单独的子目录（比如build/test/bin），让可执行文件不与源文件目录混放，确保编译器不会误读二进制文件。

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