一、Catkin 概述

Catkin 是 ROS（Robot Operating System）的官方构建系统，用于组织、编译和管理 ROS 包。它基于 CMake 并提供了更便捷的工作流，支持多包并行编译、依赖解析和环境配置。本文将详细介绍 Catkin 的常用命令及其应用场景。

二、工作空间初始化命令

1. 创建工作空间

代码解读

mkdir -p ~/catkin_ws/src

cd ~/catkin_ws/src catkin_init_workspace # 初始化 src 目录为 Catkin 工作空间

cd ~/catkin_ws catkin_make # 编译工作空间（生成 devel 和 build 目录）

说明：catkin_init_workspace 会在 src 目录下生成 CMakeLists.txt 链接文件，标记该目录为 Catkin 工作空间。

2. 创建 Catkin 包

cd ~/catkin_ws/src

catkin_create_pkg my_package roscpp rospy std_msgs # 创建名为 my_package 的包，依赖 roscpp、rospy、std_msgs

参数：catkin_create_pkg <包名> [依赖1] [依赖2] ...
作用：自动生成包的基本结构（package.xml 和 CMakeLists.txt）。

三、编译与构建命令

1. 编译工作空间

cd ~/catkin_ws catkin_make # 编译整个工作空间

常用选项 ：
catkin_make -j4 # 使用 4 个线程并行编译（加快速度） catkin_make -DCMAKE_BUILD_TYPE=Release # 设置编译类型为 Release（优化性能） catkin_make --only-pkg-with-deps my_package # 仅编译 my_package 及其依赖

2. 增量编译

catkin_make --pkg my_package # 仅编译指定包

catkin_make --force-cmake # 强制重新运行 CMake 配置（修改 CMakeLists.txt 后需要）

3. 安装编译结果

catkin_make install # 将编译结果安装到 install 目录

注意：安装后需通过 source install/setup.bash 更新环境变量。

四、包管理命令

1. 列出工作空间中的包

catkin list # 列出所有包及其状态（已编译/未编译）

catkin list --unbuilt # 仅显示未编译的包

catkin list --quiet # 仅显示包名（无状态信息）

2. 查看包依赖关系

catkin list --deps # 显示包及其依赖关系 catkin graph # 生成依赖关系图（文本形式） catkin graph --dot > deps.dot # 生成 DOT 格式依赖图，可转换为 PDF 可视化

3. 过滤编译包

# 白名单：仅编译指定包

catkin_make -DCATKIN_WHITELIST_PACKAGES="pkg1;pkg2"

# 黑名单：跳过指定包

catkin_make -DCATKIN_BLACKLIST_PACKAGES="pkg3;pkg4"

五、环境配置命令

1. 设置环境变量

source devel/setup.bash # 临时设置当前终端的 ROS 环境变量

echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc # 永久设置

验证：echo $ROS_PACKAGE_PATH 应显示工作空间路径。

2. 检查环境信息`前工作空间路径 catkin locate --shell-verbs # 显示环境设置命令`

六、高级工具命令

1. 使用 catkin_tools（推荐替代方案）

安装

sudo apt install python3-catkin-tools

配置工作空间使用 catkin_tools

cd ~/catkin_ws

catkin config --init --mkdirs # 初始化配置

catkin build # 编译工作空间（替代 catkin_make）

优势：并行编译速度更快，支持多配置管理。

2. 清理编译结果

catkin clean # 清理所有编译结果

catkin clean -b # 仅删除 build 目录

catkin clean -d # 仅删除 devel 目录

七、实战场景示例

1. 创建并编译新包

cd ~/catkin_ws/src catkin_create_pkg my_robot roscpp sensor_msgs

cd ~/catkin_ws catkin_make source devel/setup.bash

2. 仅更新特定包

修改了 my_package 后

cd ~/catkin_ws catkin_make --pkg my_package

3. 可视化依赖关系