你遇到的编译错误： ``` fatal error: onnxruntime-linux-x64-gpu-1.16.3/include/onnxruntime_cxx_api.h: No such file or directory ``` ✅ **根本原因**： 你在 `ALIKEDExtractor.h`（注意：你写的是 `ALIKEDExtractor.h`，但之前讨论的是 `ALIKEExtractor.h` —— 拼写不一致！先统一命名）中**硬编码了绝对路径包含头文件**： ```cpp #include <onnxruntime-linux-x64-gpu-1.16.3/include/onnxruntime_cxx_api.h> ``` 而该路径在你的系统上**并不存在**（你可能只解压了 ONNX Runtime，但没放在那个路径下，或路径名不匹配）。 --- ## ✅ 正确做法：**不要硬编码路径！用标准 CMake + `target_include_directories` 管理头文件** 下面我给你一套 **100% 可复现、跨平台、无硬编码、支持 CPU/GPU 切换** 的完整解决方案。 --- ## ✅ 一、第一步：确认 ONNX Runtime 已正确安装（2 种推荐方式） ### ✅ 方式 A：使用系统级安装（推荐，最干净） ```bash # 下载官方预编译包（GPU 版本） wget https://github.com/microsoft/onnxruntime/releases/download/v1.16.3/onnxruntime-linux-x64-gpu-1.16.3.tgz tar -xzf onnxruntime-linux-x64-gpu-1.16.3.tgz # 安装头文件到系统目录（需 sudo） sudo cp -r onnxruntime-linux-x64-gpu-1.16.3/include/onnxruntime /usr/include/ # 安装库文件到系统目录 sudo cp onnxruntime-linux-x64-gpu-1.16.3/lib/libonnxruntime.so* /usr/lib/ sudo ldconfig # 刷新动态库缓存 ``` ✅ 验证是否成功： ```bash ls /usr/include/onnxruntime/core/session/onnxruntime_cxx_api.h # 应存在 ls /usr/lib/libonnxruntime.so* # 应存在 pkg-config --modversion onnxruntime # 若有 pkg-config 文件则更好（见下方） ``` > 💡 如果你没有 `pkg-config` 支持，我们手动配置（见第二步）。 --- ### ✅ 方式 B：本地解压 + CMake 自动发现（无需 sudo） ```bash # 创建 vendor 目录 mkdir -p vendor/onnxruntime cd vendor/onnxruntime wget https://github.com/microsoft/onnxruntime/releases/download/v1.16.3/onnxruntime-linux-x64-gpu-1.16.3.tgz tar -xzf onnxruntime-linux-x64-gpu-1.16.3.tgz # 解压后结构：./onnxruntime-linux-x64-gpu-1.16.3/include/onnxruntime/... ``` ✅ 记住这个路径：`$PWD/onnxruntime-linux-x64-gpu-1.16.3` --- ## ✅ 二、第二步：修改 CMakeLists.txt（关键！） > 📌 修改位置：**项目根目录下的 `CMakeLists.txt`**（不是 `src/CMakeLists.txt`） ### ✅ 替换掉所有硬编码 include，改为标准 `find_package` + `target_include_directories` #### 🔧 修改前（错误）： ```cmake # ❌ 错误：硬编码路径，不可移植 include_directories(/home/juju/onnxruntime/include) ``` #### ✅ 修改后（正确）： ```cmake # === ONNX Runtime Detection (CPU or GPU) === # 优先尝试 pkg-config（如果已安装） find_package(PkgConfig QUIET) if(PkgConfig_FOUND) pkg_check_modules(ONNXRUNTIME QUIET onnxruntime) endif() # 如果 pkg-config 失败，手动查找（推荐用于本地 vendor） if(NOT ONNXRUNTIME_FOUND) # 👇 替换为你自己的实际路径！ set(ONNXRUNTIME_ROOT_DIR "${CMAKE_SOURCE_DIR}/vendor/onnxruntime/onnxruntime-linux-x64-gpu-1.16.3") find_path(ONNXRUNTIME_INCLUDE_DIRS NAMES onnxruntime_cxx_api.h PATHS ${ONNXRUNTIME_ROOT_DIR}/include /usr/include/onnxruntime /usr/local/include/onnxruntime PATH_SUFFIXES onnxruntime onnxruntime/core/session ) find_library(ONNXRUNTIME_LIBRARIES NAMES onnxruntime PATHS ${ONNXRUNTIME_ROOT_DIR}/lib /usr/lib /usr/local/lib ) endif() # === 检查是否找到 === if(NOT ONNXRUNTIME_INCLUDE_DIRS OR NOT ONNXRUNTIME_LIBRARIES) message(FATAL_ERROR "❌ ONNX Runtime not found!\n" "Please install it, or set ONNXRUNTIME_ROOT_DIR to your local path.\n" "Current search paths:\n" " Includes: ${ONNXRUNTIME_INCLUDE_DIRS}\n" " Libraries: ${ONNXRUNTIME_LIBRARIES}") else() message(STATUS "✅ Found ONNX Runtime: ${ONNXRUNTIME_INCLUDE_DIRS}") endif() # === 导入为 INTERFACE 库（供 src/ 使用）=== add_library(onnxruntime INTERFACE) target_include_directories(onnxruntime INTERFACE ${ONNXRUNTIME_INCLUDE_DIRS}) target_link_libraries(onnxruntime INTERFACE ${ONNXRUNTIME_LIBRARIES}) # === 在 src/ 子项目中链接它 === add_subdirectory(src) ``` > ✅ 然后在 `src/CMakeLists.txt` 中，只需： ```cmake # src/CMakeLists.txt target_link_libraries(${PROJECT_NAME} PRIVATE onnxruntime) # 不需要 include_directories()！因为 onnxruntime 是 INTERFACE 库 ``` --- ## ✅ 三、第三步：修复你的头文件（`ALIKEExtractor.h`） > ⚠️ 注意：你写的是 `ALIKEDExtractor.h`（多了一个 D），请统一为 `ALIKEExtractor.h`（和类名一致）！ #### ✅ 修改前（错误，硬编码路径）： ```cpp // ❌ 错误！ #include <onnxruntime-linux-x64-gpu-1.16.3/include/onnxruntime_cxx_api.h> ``` #### ✅ 修改后（正确，标准包含）： ```cpp // include/ALIKEExtractor.h #pragma once #include <opencv2/opencv.hpp> #include "ORBextractor.h" // ✅ 正确：直接包含，由 CMake 提供路径 #include <onnxruntime_cxx_api.h> class ALIKEExtractor : public ORBextractor { // ... 类定义不变 }; ``` ✅ 编译器会自动在 `ONNXRUNTIME_INCLUDE_DIRS` 路径下搜索 `onnxruntime_cxx_api.h`，无需你写路径。 --- ## ✅ 四、第四步：验证是否真正修复（3 行命令） ```bash # 1. 清理并重新配置 CMake（关键！） rm -rf build/ && mkdir build && cd build cmake .. -DCMAKE_BUILD_TYPE=Release # 2. 查看 CMake 是否找到 ONNX Runtime # 输出中应有：✅ Found ONNX Runtime: /xxx/onnxruntime-linux-x64-gpu-1.16.3/include # 3. 编译（不再报头文件错误） make -j4 ``` ✅ 成功 = 无 `fatal error: .../onnxruntime_cxx_api.h: No such file`。 --- ## ✅ 五、Bonus：如果你用 conda（快速方案） ```bash conda activate your_env conda install -c conda-forge onnxruntime-gpu # 然后在 CMakeLists.txt 中用 pkg-config（更简单）： find_package(PkgConfig REQUIRED) pkg_check_modules(ONNXRUNTIME REQUIRED onnxruntime) target_link_libraries(${PROJECT_NAME} PRIVATE ${ONNXRUNTIME_LIBRARIES}) target_include_directories(${PROJECT_NAME} PRIVATE ${ONNXRUNTIME_INCLUDE_DIRS}) ``` --- ## ✅ 六、常见错误速查表 | 错误现象 | 原因 | 解决 | |----------|------|------| | `onnxruntime_cxx_api.h: No such file` | 头文件路径未加入 `target_include_directories` | ✅ 检查 `CMakeLists.txt` 中 `target_include_directories(...)` 是否作用于你的 `ALIKEExtractor` 所在 target | | `undefined reference to 'Ort::Session::Session'` | `.so` 库未链接，或链接顺序错（必须在 OpenCV 之后） | ✅ `target_link_libraries(... onnxruntime ${OpenCV_LIBS})`，确保 `onnxruntime` 在前 | | `libonnxruntime.so: cannot open shared object file` | 运行时找不到 `.so` | ✅ `export LD_LIBRARY_PATH=/path/to/onnxruntime/lib:$LD_LIBRARY_PATH`，或 `sudo ldconfig` | | `CUDA initialization failed` | GPU 版本 ONNX Runtime 未找到 CUDA 驱动 | ✅ `nvidia-smi` 看驱动版本 ≥ 11.8；`ls /usr/local/cuda-11.8` 是否存在 | --- ## ✅ 总结：你现在只需做这 3 件事 | 步骤 | 操作 | 文件 | |------|------|------| | **① 统一命名** | 把 `ALIKEDExtractor.h` → `ALIKEExtractor.h`，类名也同步 | `include/`, `src/` | | **② 配置 CMake** | 按上方 `CMakeLists.txt` 片段替换，设置 `ONNXRUNTIME_ROOT_DIR` | `CMakeLists.txt` | | **③ 修复头文件** | 删除硬编码 `#include <...>`，改为 `#include <onnxruntime_cxx_api.h>` | `include/ALIKEExtractor.h` | ✅ 完成后，`make` 就能过，且完全可移植（别人 clone 你的代码，只要放对 ONNX Runtime 路径，就能编译）。 --- 需要我帮你： - ✅ 自动生成适配你当前路径的 `CMakeLists.txt` 片段？（告诉我你的 `onnxruntime` 解压在哪） - ✅ 写一个一键检测脚本（检查头文件、库、CUDA 是否就绪）？ - ✅ 提供 `ALIKEExtractor.h/.cc` 的完整可编译模板（含 fallback 和日志）？ 请直接说 👇 我立刻生成。你已经越过最大障碍 —— **路径地狱**，接下来全是直路。 ---