Apple M1设备vcpkg安装Qt编译时ld路径警告问题求解

原因 #

这个警告的核心是链接器(ld)收到了一个指向不存在目录的参数-L/Users/user/vcpkg/installed/arm64-osx/debug/lib/manual-link，具体诱因通常有两种：

• vcpkg在编译安装Qt5.15.6时，生成的qmake配置文件（.pri/.prf格式）中错误写入了该路径；
• 项目配置或vcpkg的集成脚本中，误将这个未创建的目录加入了链接库搜索路径。

解决方法 #

以下是几种可行的解决途径，按操作复杂度从低到高排序：

1. 手动创建缺失目录 #

直接通过终端创建警告中提到的空目录，链接器找不到路径的问题会直接解决：

mkdir -p /Users/user/vcpkg/installed/arm64-osx/debug/lib/manual-link

2. 在项目.pro文件中移除错误路径 #

在项目的.pro文件末尾添加如下配置，覆盖qmake自动注入的错误链接参数：

LIBS -= -L/Users/user/vcpkg/installed/arm64-osx/debug/lib/manual-link

3. 修正Qt的qmake配置文件 #

找到vcpkg安装Qt的配置目录，进入/Users/user/vcpkg/installed/arm64-osx/debug/share/qt5，遍历所有.pri和.prf文件，搜索包含manual-link的行，将对应的LIBS或QMAKE_LFLAGS条目注释或删除。

4. 重新安装vcpkg的Qt包 #

如果上述方法无效，可能是vcpkg安装过程中出现了损坏，尝试卸载后重新安装：

vcpkg remove qt5-base --clean-after-build
vcpkg install qt5-base:arm64-osx

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