ROS1换个终端就找不到功能包？先查这四件事

一个终端能找到功能包，新开一个终端却提示找不到。遇到这种情况，先比较两个终端的环境，再决定是否需要重新安装或编译。文件还在磁盘上，不代表当前终端已经知道去哪里找它。

本文讨论ROS1与catkin的常见环境问题，适合黑蚁LITE的ROS基础学习。以下命令是教学示例，没有在当前车辆上执行，也不需要启动底盘。

一、先确认：两个终端用的是同一套环境吗？

在能用和不能用的终端里，分别检查：

printf '%s\n' "$ROS_DISTRO"
command -v rospack
printf '%s\n' "$ROS_PACKAGE_PATH"

第一项查看当前环境声明的ROS发行版；第二项查看能否找到rospack，以及实际命中的命令位置；第三项查看ROS包搜索路径。它们都是排查线索，不是“安装完整、所有依赖正常”的证明。

如果发行版不同，或者一个终端能找到rospack、另一个找不到，先检查各自加载过什么环境。电脑本机、SSH连接、容器和IDE终端也要分清：在本机加载过环境，并不等于远端或容器里的终端已经完成相同设置。

source会在当前shell中执行指定脚本。它不会把一次临时设置自动写入所有其他终端。catkin提供的setup.bash、setup.zsh等文件，则用来设置对应shell的环境。

例如，只有当使用ROS Noetic、Bash、工作空间确实为~/catkin_ws，且已经生成相应devel环境时，下面才是适用的示例。demo_pkg需要替换成实际包名：

source /opt/ros/noetic/setup.bash
source ~/catkin_ws/devel/setup.bash
rospack find demo_pkg

这些路径不是黑蚁LITE的固定出厂目录。实际工程可能使用install空间、隔离构建或其他布局，应按交付说明加载对应环境。工作空间的setup文件还可能带有构建时的底层环境链，不能把示例理解成所有项目都必须机械地重复加载两遍。

如果setup文件不存在，先核对工作空间位置、构建方式和构建结果。不要为了让报错消失，随手创建一个同名空文件，也不要把别的项目路径直接照抄过来。

rospack find后面使用的是功能包名称。按package.xml中的名称核对，别只凭文件夹名字猜。找到包后，检查返回的完整路径是否属于这次要使用的工程。

如果磁盘上有两份同名包，只看到“查找成功”还不够：命中的可能是旧工程。此时应核对加载的工作空间及顺序，再确认包路径。仅仅cd进入新工程目录，并不等于ROS已经切换到该工程。

包路径正确后，再检查launch文件名、节点可执行文件和依赖。如果错误已经变成“找不到某个节点”或“缺少某个库”，就沿新的报错继续查；包被找到，只说明包发现这一环有了结果。

先手动加载正确环境，确认命令位置和包路径都符合预期，再考虑整理终端启动配置。对于交互式、非登录的Bash，通常读取的是~/.bashrc；登录shell、脚本和其他shell的加载规则可能不同，不能只改一个文件就默认处处生效。

检查启动文件里是否重复加载了旧工作空间、混入了其他ROS版本，或写了已经失效的目录。修改后新开终端，重新执行前面的检查，确认能稳定找到预期包。不要把机器人启动或运动命令夹在这次环境修复里。

图蜂科技公开资料列明黑蚁LITE标准软件环境为ROS1，配套课程覆盖ROS开发工具等内容。具体发行版、工程路径和软件模块，应核对自己收到的控制器与交付资料；ROS2适配范围需另行确认。

用一个已经确认可用的教学包，在两个终端分别填写“发行版、rospack位置、包搜索路径、实际包路径”四项。手动加载正确环境后再对照一次。这个练习的目标，是解释环境为什么影响包查找，不是验证建图、导航或车辆性能。

下次遇到同样报错，可以按这个顺序处理：先确认终端身份，再核对环境文件，然后检查实际命中的包路径，最后用新终端复查。每一步都有具体输出，下一步就不必靠猜。

GNU Bash参考手册：source、当前shell与启动文件规则。
https://www.gnu.org/s/bash/manual/bash.html

ROS rospack源码：环境搜索路径读取与包路径查找。
https://github.com/ros/rospack/blob/noetic-devel/src/rospack.cpp

本文部分内容由AI辅助整理，并依据上述原始资料核查。示例用于说明排查方法，不代表当前车辆的实测结果或固定配置。