踩坑/Robotics Stack Exchange·2023-11-28

ROS2 Humble 构建出现 SetuptoolsDeprecationWarning

在 ROS2 Humble 用 colcon build 构建包时出现 setup.py install is deprecated 警告，可降级 setuptools 或用 PYTHO…

AI 整理

• 本体 SDK 与控制
• 端侧部署

本文由 AI 根据公开内容整理，可能有误，请以原文为准：SetuptoolsDeprecationWarning in ros2 Humble（Robotics Stack Exchange #24230）

状态：有绕过办法

问题

执行 colcon build --packages-select py_launch_example 后包能完成构建，但 stderr 输出 SetuptoolsDeprecationWarning: setup.py install is deprecated，并伴随 package index 与 package.xml 隐式安装警告。

环境

Ubuntu 22.04 LTS；ROS 2 Humble；Python 3.10.6；包 py_launch_example。

解决办法

1. 将 setuptools 降级到 58.2.0，提问者表示警告不再出现。
2. 或在 .bashrc 添加 PYTHONWARNINGS="ignore:setup.py install is deprecated::setuptools.command.install"; export PYTHONWARNINGS，用于抑制该特定警告。

原问题作者：Jishnu；采纳答案作者：cottsay。原内容依 CC BY-SA 4.0 授权，本页摘要同样依 CC BY-SA 4.0 授权。

来源

本页事实对应的公开页面，以原文为准。

1. Robotics Stack Exchange #24230：SetuptoolsDeprecationWarning in ros2 Humble访问 2026-10-22