MacOS构建libtorch遇链接错误及头文件缺失问题求助

1. 链接错误：ld不识别--no-as-needed系列选项 #

错误信息：

ld: unknown options: --no-as-needed --as-needed --no-as-needed --as-needed
c++: error: linker command failed with exit code 1 (use -v to see invocation)

解决方法：

• 替换编译器工具链：macOS默认的ld属于Clang工具链，不支持GCC链接器的--no-as-needed参数，把编译命令里的g++换成clang++即可避免该参数冲突。
• 改用CMake构建（推荐）：手动写编译命令容易遗漏依赖或适配错误，官方推荐用CMake自动处理平台差异。示例CMake配置：

cmake_minimum_required(VERSION 3.18 FATAL_ERROR)
project(example-app)

find_package(Torch REQUIRED)
set(CMAKE_CXX_STANDARD 17)

add_executable(example-app example-app.cpp)
target_link_libraries(example-app "${TORCH_LIBRARIES}")

执行构建：

mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH=/path/to/libtorch
make

2. 头文件缺失错误：找不到torch/csrc/autograd/autograd.h #

错误信息：

/opt/homebrew/Cellar/pytorch/2.5.1_3/libexec/lib/python3.13/site-packages/torch/include/torch/csrc/api/include/torch/autograd.h:3:10: fatal error: 'torch/csrc/autograd/autograd.h' file not found

解决方法：
编译命令需要同时包含torch的根include目录和API子目录，还要链接必要的库文件。修正后的命令：

clang++ example-app.cpp -o out \
-I/opt/homebrew/Cellar/pytorch/2.5.1_3/libexec/lib/python3.13/site-packages/torch/include \
-I/opt/homebrew/Cellar/pytorch/2.5.1_3/libexec/lib/python3.13/site-packages/torch/include/torch/csrc/api/include \
-L/opt/homebrew/Cellar/pytorch/2.5.1_3/libexec/lib/python3.13/site-packages/torch/lib \
-ltorch -ltorch_cpu -lc10 \
-std=c++17

• -I参数：补充根include目录，让编译器能解析头文件里的相对路径引用；
• -L和-l参数：指定torch库路径并链接核心库，避免后续运行时依赖缺失。

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