ROS2中CMakeLists正确链接C文件与头文件的问题求助

假设你的ROS2包结构如下（如果有差异，对应调整路径即可）：

your_imu_package/
├── include/
│   └── imu_driver/
│       └── imu_sensor.h  # C驱动头文件
├── src/
│   ├── imu_sensor.c       # C驱动实现文件
│   └── imu_data_reader.cpp # C++节点文件
├── package.xml
└── CMakeLists.txt

1. 推荐方案：用静态库编译（彻底解决运行时库找不到问题） #

静态库会把C驱动代码直接嵌入到C++节点的可执行文件中，不需要单独处理库的路径，适合新手。以下是完整的CMakeLists.txt配置：

cmake_minimum_required(VERSION 3.8)
project(imu_driver_package)

# 查找ROS2核心依赖（根据你的节点用到的消息类型调整，比如sensor_msgs）
find_package(rclcpp REQUIRED)
find_package(sensor_msgs REQUIRED)

# 1. 把C驱动编译为静态库
add_library(imu_sensor STATIC
  src/imu_sensor.c
)

# 2. 指定头文件搜索目录，让编译器找到include下的C头文件
target_include_directories(imu_sensor PUBLIC
  $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
  $<INSTALL_INTERFACE:include>
)

# 3. 编译C++节点可执行文件
add_executable(imu_data_reader src/imu_data_reader.cpp)

# 4. 链接静态库和ROS2依赖库
target_link_libraries(imu_data_reader
  PRIVATE
  imu_sensor
  rclcpp::rclcpp
  sensor_msgs::sensor_msgs # 如果用到IMU消息，保留；否则删除
)

# 5. 安装节点和库（遵循ROS2规范，确保能被ros2 run找到）
install(TARGETS imu_data_reader imu_sensor
  DESTINATION lib/${PROJECT_NAME}
)

install(DIRECTORY include/
  DESTINATION include
)

2. C++节点中正确使用extern "C" #

在imu_data_reader.cpp中，必须用extern "C"包裹C头文件，避免C++的名字修饰规则破坏C函数的命名：

#include "rclcpp/rclcpp.hpp"
#include "sensor_msgs/msg/imu.hpp" // 根据你的需求添加消息头

// 关键：用extern "C"包裹所有C头文件
extern "C" {
#include "imu_driver/imu_sensor.h"
}

int main(int argc, char * argv[]) {
  rclcpp::init(argc, argv);
  
  // 调用C驱动的函数（示例）
  imu_sensor_init();
  
  auto node = std::make_shared<rclcpp::Node>("imu_reader_node");
  // 你的节点逻辑...
  
  rclcpp::spin(node);
  rclcpp::shutdown();
  return 0;
}

3. 如果你坚持用共享库（SHARED） #

如果一定要用动态库，除了把CMakeLists.txt中的STATIC改成SHARED，还需要确保运行时能找到库：

• 编译后必须在工作空间根目录执行source install/setup.bash，这会自动设置系统的库搜索路径
• 如果还是报错，可以手动指定库路径：

  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$(pwd)/install/imu_driver_package/lib
  

4. 检查package.xml的依赖配置 #

确保package.xml包含了必要的编译和运行依赖，示例如下：

<?xml version="1.0"?>
<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
<package format="3">
  <name>imu_driver_package</name>
  <version>0.0.0</version>
  <description>IMU driver package for ROS2</description>
  <maintainer email="your_email@example.com">Your Name</maintainer>
  <license>Apache-2.0</license>

  <buildtool_depend>ament_cmake</buildtool_depend>
  <depend>rclcpp</depend>
  <depend>sensor_msgs</depend> <!-- 根据你的消息类型调整 -->

  <build_depend>ament_cmake</build_depend>
  <exec_depend>rclcpp</exec_depend>
  <exec_depend>sensor_msgs</exec_depend>

  <export>
    <build_type>ament_cmake</build_type>
  </export>
</package>

编译运行步骤 #

# 进入工作空间根目录
colcon build --packages-select imu_driver_package
source install/setup.bash
ros2 run imu_driver_package imu_data_reader

内容的提问来源于stack exchange，提问作者Andrew.M