你遇到的这条信息： ``` runtime library [libpython3.10.so.1.0] in /usr/lib/aarch64-linux-gnu may be hidden by files in: /usr/lib/x86_64-linux-gnu ``` 是 CMake 的一个 **运行时库路径冲突警告**，表示你的构建系统中存在不同架构的库路径冲突问题。 --- ### 🔍 问题分析： - **`libpython3.10.so.1.0`** 是 Python 3.10 的共享库文件。 - 你当前正在构建的项目（如 ROS 2 包）依赖于 **ARM64（aarch64）架构** 的库，位于： ``` /usr/lib/aarch64-linux-gnu ``` - 但 CMake 检测到 **x86_64 架构** 的库路径也存在： ``` /usr/lib/x86_64-linux-gnu ``` - 这意味着：**运行时可能加载错误架构的库**，导致程序崩溃或不可预测的行为。 --- ### 🛠️ 常见原因： 1. **交叉编译环境配置不当**：在 x86 主机上编译面向 aarch64 的程序，但系统中混用了两个架构的库。 2. **环境变量污染**：如 `LD_LIBRARY_PATH` 或 `CMAKE_LIBRARY_PATH` 中包含了错误的库路径。 3. **Python 安装版本与目标架构不一致**：使用的是 x86_64 的 Python，但项目是为 aarch64 构建的。 4. **多架构系统（如 Ubuntu ARM64 + x86_64）**：系统同时安装了多个架构的库，导致冲突。 --- ### ✅ 解决方法： #### 1. **使用工具链文件进行交叉编译（推荐）** 创建一个 `toolchain-aarch64.cmake` 文件，明确指定目标架构和库路径： ```cmake set(CMAKE_SYSTEM_NAME Linux) set(CMAKE_SYSTEM_PROCESSOR aarch64) set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc) set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++) set(CMAKE_FIND_ROOT_PATH /usr/aarch64-linux-gnu) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) ``` 然后在构建时指定： ```bash cmake -DCMAKE_TOOLCHAIN_FILE=toolchain-aarch64.cmake .. ``` #### 2. **清理环境变量** 确保没有将 x86_64 的库路径包含进环境变量中： ```bash unset LD_LIBRARY_PATH unset LIBRARY_PATH ``` 或者设置为 aarch64 架构路径： ```bash export LD_LIBRARY_PATH=/usr/lib/aarch64-linux-gnu export LIBRARY_PATH=/usr/lib/aarch64-linux-gnu ``` #### 3. **确认 Python 架构是否匹配** 使用以下命令查看 Python 的库路径： ```bash python3-config --exec-prefix ``` 确保输出路径是 `/usr` 或 `/usr/lib/aarch64-linux-gnu`，而不是 `/usr/lib/x86_64-linux-gnu`。 #### 4. **使用虚拟环境（推荐）** 为构建项目创建一个独立的 Python 虚拟环境，避免与系统库冲突： ```bash python3 -m venv ~/myenv source ~/myenv/bin/activate ``` 然后在虚拟环境中安装依赖并构建项目。 --- ### 🧪 验证是否解决： 重新运行 `cmake` 或 `colcon build`，确认是否还有该警告。 ---