macOS C++构建遇ld警告：-undefined error已弃用，求应对指引

问题重现 #

在macOS平台构建C++项目时，触发ld链接器警告：

[build] [430/431 99% :: 9.484] Linking CXX executable foobar
[build] ld: warning: -undefined error is deprecated

项目CMake配置中使用了链接器选项：

add_link_options("-Wl,-undefined,error")

但查阅ld手册页时，并未找到该选项被弃用的相关说明。

弃用原因 #

这是Apple ld64（macOS默认链接器）版本迭代带来的语法变更：

• 旧版的逗号分隔写法-undefined error（通过-Wl,-undefined,error传递给链接器）已被标记为弃用，官方转而推荐等号分隔的语法-undefined=error，目的是统一链接器选项的语法风格，与其他同类选项的写法对齐。
• 手册未及时更新属于工具文档滞后的常见情况，Apple开发者工具文档有时会跟不上实际工具的功能变化。

替代方案 #

方案1：修改选项语法 #

将CMake中的链接器选项改为等号分隔的形式，既消除警告，又保留原有功能：

add_link_options("-Wl,-undefined=error")

方案2：移除显式配置（推荐） #

根据ld手册说明，-undefined的默认行为就是error，如果项目没有特殊链接需求，直接移除这条add_link_options配置即可，依赖默认行为完全能达到相同效果，同时彻底消除警告。

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