Windows下ROS2 Foxy执行colcon build时报pkg_resources模块缺失错误

问题原因分析 #

出现ModuleNotFoundError: No module named 'pkg_resources'通常有以下核心原因：

• ROS2终端使用的Python环境与安装setuptools的全局Python环境不一致，colcon调用的Python找不到pkg_resources
• --merge-install参数导致安装目录合并后，Python模块路径被覆盖或未正确注册
• setuptools虽已安装，但未被当前ROS2环境的Python正确加载

解决方案 #

1. 强制在ROS2环境中升级setuptools #

打开ROS2专属终端（比如ROS2 Foxy Command Prompt），直接执行：

python -m pip install --upgrade setuptools==65.6.3

确保当前终端使用的Python环境中存在可用的pkg_resources，避免环境不匹配问题。

2. 验证colcon使用的Python路径 #

在ROS2终端中运行：

where python
python -c "import pkg_resources; print('Found pkg_resources')"

如果第二条命令报错，重复步骤1；如果成功，说明问题出在colcon构建时的路径配置。

3. 暂时移除--merge-install参数测试 #

先尝试不带合并参数构建：

colcon build

如果构建成功，说明--merge-install的目录合并逻辑干扰了Python模块查找。此时可以手动指定Python路径给colcon：

colcon build --merge-install --cmake-args -DPython3_EXECUTABLE:FILEPATH="C:\Python38\python.exe"

替换路径为你验证过的、对应ROS2 Foxy版本的Python绝对路径（ROS2 Foxy要求Python3.8）。

4. 调整CMakeLists.txt确保Python解释器一致 #

在test1包的CMakeLists.txt开头添加以下代码，强制CMake使用终端当前的Python解释器：

find_package(Python3 REQUIRED COMPONENTS Interpreter)
set(Python3_EXECUTABLE "${Python3_EXECUTABLE}" CACHE PATH "Python interpreter path" FORCE)
message(STATUS "Using Python interpreter: ${Python3_EXECUTABLE}")

重新构建时查看终端输出的Python路径，确认和你验证过的路径一致。

5. 重置ROS2环境变量 #

关闭当前终端，重新打开ROS2专属终端，运行安装目录下的setup脚本确保环境加载正确：

call C:\dev\ros2_foxy\setup.bat

替换路径为你的ROS2 Foxy实际安装路径。

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