Ubuntu 20.04学习ROS1过程中报错修正指南 （从入门到排错，持续更新）

一、环境准备与安装报错

在安装ROS1时，最容易遇到的是源和密钥问题。例如，执行sudo apt update时出现“由于没有公钥，无法验证下列签名”的错误，这属于典型的ROS1安装报错。解决方法：手动添加缺失的密钥，参考官方文档添加密钥服务器。

另一个常见问题是依赖包缺失，比如ros--desktop-full安装失败。此时可以尝试apt --fix-broken install修复，或者更换软件源。

二、编译工作空间时的ROS1编译错误

使用catkin_make编译时，经常遇到“Could not find a package configuration file”之类的ROS1编译错误。这通常是因为缺少某个依赖库，需要根据错误提示安装相应的ROS包或系统库。例如，如果提示找不到cv_bridge，则安装ros-noetic-cv-bridge。

另外，Python版本不匹配也会导致ROS1编译错误。Ubuntu20.04默认Python3，但ROS1 Noetic支持Python3，一般不会冲突，但若自定义了Python路径，需确保CMake找到正确的Python解释器。

三、运行节点时的ROS1运行错误

运行rosrun或roslaunch时可能出现“无法找到节点”的ROS1运行错误。首先确认roscore是否已启动，然后检查包名和节点名是否正确。另一个常见错误是权限问题，例如串口设备无法访问，需要将用户添加到dialout组。

当遇到Resource not found时，可能是环境变量ROS_PACKAGE_PATH未包含你的工作空间，执行source devel/setup.bash即可。

四、持续更新计划

本文将持续收集更多Ubuntu20.04 ROS1学习中的报错案例，并更新解决方案。欢迎在评论区留言你遇到的错误，我们会优先处理。也欢迎关注本系列教程，一起攻克ROS1难关！

最后更新时间：2026-03-15