Win10下ROS2 Humble用colcon构建包时遇ModuleNotFoundError错误

问题根源 #

报错显示Anaconda的Python环境找不到catkin_pkg模块，核心原因是当前命令行优先调用了Anaconda的Python，而非ROS 2 Humble自带的Python环境，且Anaconda环境未安装该依赖包。

解决步骤 #

• 确认当前Python环境
  在VS2019命令行执行：

  where python
  

  查看输出的第一个路径是否为Anaconda的Python（如C:\ProgramData\Anaconda3\python.exe），确认环境冲突情况。

• 方法1：切换到ROS2自带Python环境

  1. 关闭当前命令行窗口，重新以管理员身份打开VS2019命令行。
  2. 手动调整PATH优先级，让ROS2的Python优先被调用：

     set PATH=C:\ROS_Humble\ros2\x64;%PATH%
     

     （路径根据你的ROS2实际安装目录调整）
  3. 重新加载ROS2环境：

     call C:\ROS_Humble\ros2\local_setup.bat
     

  4. 再次执行构建命令：

     colcon build --symlink-install --merge-install
     

• 方法2：给Anaconda环境安装依赖
  如果需要保留使用Anaconda的Python环境，直接在命令行执行：

  pip install catkin_pkg
  

  安装完成后重新运行构建命令即可。

验证 #

构建命令执行后，若不再出现ModuleNotFoundError提示，说明问题已解决。

内容的提问来源于stack exchange，提问作者DrBwts