Ubuntu 20.04 ROS新手避坑：catkin_make报‘empy’错误的完整解决流程
Ubuntu 20.04 ROS新手避坑指南：彻底解决catkin_make的'empy'报错
刚接触ROS的开发者，在Ubuntu 20.04上搭建第一个工作空间时，常常会被一个看似简单却令人头疼的问题绊住脚步——catkin_make命令执行时出现的"Could NOT find PY_em"错误。这个报错背后隐藏着Python环境配置的复杂性，特别是当系统同时存在多个Python解释器时。本文将带你深入理解问题根源，并提供一套完整的解决方案。
1. 错误现象与初步诊断
当你在终端执行catkin_make命令时，可能会看到如下错误信息：
CMake Error at /opt/ros/noetic/share/catkin/cmake/empy.cmake:30 (message): Unable to find either executable 'empy' or Python module 'em'... try installing the package 'python3-empy'这个错误的核心是系统找不到Python的empy模块。值得注意的是，错误信息中提到了PYTHON_EXECUTABLE的路径：
-- Using PYTHON_EXECUTABLE: /home/xxx/anaconda3/bin/python3这表明cmake正在尝试使用Anaconda环境中的Python解释器，而非系统默认的Python。这是许多新手容易忽视的关键点。
常见无效尝试：
pip install empy：虽然能安装empy包，但可能安装到错误的Python环境中pip install -U rosdep rosinstall_generator...：这些包与empy问题无直接关联
2. 问题根源分析
这个报错通常由以下原因导致：
- Python环境冲突：系统同时存在多个Python解释器（如系统Python、Anaconda Python），而catkin_make使用了非预期的解释器
- 包安装位置错误：empy模块被安装到了某个Python环境的site-packages中，但catkin_make查找的是另一个环境
- 系统包缺失：Ubuntu系统中未安装
python3-empy这个系统级Python包
理解这些底层原因，才能避免治标不治本的解决方案。
3. 完整解决方案
3.1 安装系统级empy包
首先，确保系统级别的empy包已安装：
sudo apt-get update sudo apt-get install python3-empy这个命令会安装Ubuntu官方维护的empy包，它将位于系统Python的site-packages目录中。
3.2 检查并修正Python解释器路径
查看当前catkin_make使用的Python解释器：
echo $PYTHON_EXECUTABLE如果显示的是Anaconda路径而非系统Python（通常是/usr/bin/python3），则需要明确指定Python解释器：
catkin_make -DPYTHON_EXECUTABLE=/usr/bin/python3首次构建成功后，后续构建可以直接使用catkin_make，无需重复指定。
3.3 处理Anaconda环境冲突
如果你确实需要使用Anaconda环境，可以尝试以下方法：
- 在Anaconda环境中安装empy：
conda install -c conda-forge empy- 确保环境变量正确设置：
export PYTHON_EXECUTABLE=$(which python3)注意：长期解决方案是创建专门的conda环境用于ROS开发，避免与基础环境冲突。
4. 验证解决方案
完成上述步骤后，通过以下方式验证问题是否解决：
- 检查empy模块是否可导入：
python3 -c "import em; print(em.__file__)"- 清理之前的构建并重新尝试：
cd ~/catkin_ws rm -rf build devel catkin_make5. 深入理解与预防措施
为了避免类似问题再次发生，建议：
- 统一Python环境：ROS开发最好使用系统Python或专门的虚拟环境
- 理解ROS与Python版本关系：ROS Noetic专为Python3设计，而早期版本可能需要额外配置
- 环境变量管理：注意
.bashrc中的环境变量设置，特别是PYTHONPATH和PYTHON_EXECUTABLE
常见误区和陷阱：
| 误区 | 正确做法 |
|---|---|
| 盲目使用pip安装 | 优先考虑系统包管理器(apt) |
| 忽视Python解释器路径 | 明确指定catkin_make使用的Python |
| 混合使用多个环境 | 为ROS开发创建独立环境 |
6. 高级技巧：创建ROS专用开发环境
对于长期进行ROS开发的用户，建议设置专用环境：
- 创建新的conda环境：
conda create -n ros_env python=3.8 conda activate ros_env- 安装必要依赖：
conda install -c conda-forge empy catkin_pkg rospkg- 设置环境变量：
echo "export ROS_PYTHON_VERSION=3" >> ~/.bashrc echo "export PYTHONPATH=/opt/ros/noetic/lib/python3/dist-packages:$PYTHONPATH" >> ~/.bashrc这种隔离环境可以避免系统Python与开发环境的冲突。
7. 其他可能的相关问题
在解决empy问题后，你可能会遇到类似的依赖问题。以下是常见相关问题的快速参考：
- catkin_pkg缺失：
sudo apt-get install python3-catkin-pkg - rospkg缺失：
sudo apt-get install python3-rospkg - Python版本不匹配：确保所有ROS包使用相同Python版本
记住，ROS生态系统强烈依赖于正确配置的Python环境。花时间理解这些依赖关系，将为后续开发节省大量调试时间。