ROS新手避坑：catkin_make报错‘No module named catkin_pkg‘的5种修复方案实测

ROS新手避坑指南：彻底解决'No module named catkin_pkg'编译错误的5种实战方案

第一次在Ubuntu上搭建ROS开发环境时，那个红色的ImportError: No module named 'catkin_pkg'错误提示就像一堵墙，把无数热情的新手挡在了ROS大门外。作为过来人，我清楚地记得自己花了整整两天时间，尝试了GitHub、Stack Overflow和各类论坛上能找到的所有方案，最终才发现不同系统环境下需要采用完全不同的解决路径。本文将分享经过Ubuntu 18.04/20.04双系统实测的5种解决方案，帮你避开我踩过的所有坑。

1. 问题诊断与环境检查

在开始修复之前，我们需要先确认几个关键信息。打开终端，依次执行以下命令：

# 检查Python版本
python --version  # 或 python3 --version

# 查看catkin_pkg是否已安装
pip list | grep catkin-pkg
dpkg -l | grep catkin-pkg

常见的情况有两种：

• Python环境冲突：当同时安装了Anaconda时，ROS可能错误地使用了conda的Python环境
• 包管理混乱：系统中同时存在pip安装和apt安装的catkin_pkg，导致版本冲突

记录下你的ROS版本和Ubuntu版本也很重要：