1. 问题背景与现象分析
最近不少PX4开发者反馈，在配置Gazebo仿真环境时遇到了奇怪的问题：明明能成功编译并运行make px4_sitl_default gazebo，但在执行roslaunch px4 posix_sitl.launch时却频频报错，系统提示找不到px4、mavlink_sitl_gazebo等关键软件包。这个问题看似简单，实则隐藏着PX4官方代码仓库结构调整带来的路径变更问题。
我自己在升级PX4代码库后也遇到了同样的情况。经过排查发现，问题的根源在于PX4在2023年5月对代码仓库进行了结构调整，将原本位于Tools/sitl_gazebo的仿真相关文件移动到了新的Tools/simulation/gazebo-classic目录下。这个变更虽然合理，但却导致大量旧教程和文档中的路径配置失效。
2. 新旧路径对比与问题诊断
2.1 旧版路径结构解析
在2023年5月之前的PX4版本中，Gazebo仿真相关的文件主要存放在以下路径：
Tools/setup_gazebo.bash：环境配置脚本Tools/sitl_gazebo：Gazebo仿真模型和插件build/px4_sitl_default：编译输出目录
对应的环境配置命令通常是：
source Tools/setup_gazebo.bash $(pwd) $(pwd)/build/px4_sitl_default export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:$(pwd) export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:$(pwd)/Tools/sitl_gazebo2.2 新版路径结构调整
PX4团队为了更好的代码组织，将仿真相关文件重新归类：
Tools/simulation/gazebo-classic/setup_gazebo.bash：新的环境配置脚本Tools/simulation/gazebo-classic/sitl_gazebo-classic：新的Gazebo仿真资源目录build/px4_sitl_default：编译输出目录（保持不变）
这个调整使得代码结构更加清晰，但也带来了兼容性问题。很多开发者（包括我自己最初）按照旧教程操作时，系统会因为找不到文件而报错。
3. 完整解决方案
3.1 临时解决方案：终端直接配置
如果你只是临时需要运行仿真，可以在终端直接执行以下更新后的命令：
source Tools/simulation/gazebo-classic/setup_gazebo.bash $(pwd) $(pwd)/build/px4_sitl_default export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:$(pwd) export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:$(pwd)/Tools/simulation/gazebo-classic/sitl_gazebo-classic这里有几个关键点需要注意：
source命令必须放在export之前执行，因为setup_gazebo.bash脚本会设置一些必要的环境变量$(pwd)表示当前工作目录，确保你在PX4-Autopilot的根目录下执行这些命令- 路径中的
gazebo-classic和sitl_gazebo-classic是新版特有的目录名
3.2 永久解决方案：修改.bashrc文件
为了避免每次打开终端都要重新配置，更推荐的做法是将这些配置写入~/.bashrc文件。但这里有个重要区别：在.bashrc中应该使用绝对路径而非相对路径。
打开你的.bashrc文件：
nano ~/.bashrc在文件末尾添加以下内容（请将~/PX4-Autopilot替换为你实际的PX4代码库路径）：
# PX4 Gazebo仿真环境配置 source ~/PX4-Autopilot/Tools/simulation/gazebo-classic/setup_gazebo.bash ~/PX4-Autopilot ~/PX4-Autopilot/build/px4_sitl_default export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:~/PX4-Autopilot export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:~/PX4-Autopilot/Tools/simulation/gazebo-classic/sitl_gazebo-classic保存后执行：
source ~/.bashrc3.3 验证配置是否生效
为了确认配置正确，可以运行以下检查命令：
echo $ROS_PACKAGE_PATH正确的输出应该包含类似这样的路径：
/home/yourname/PX4-Autopilot:/home/yourname/PX4-Autopilot/Tools/simulation/gazebo-classic/sitl_gazebo-classic:...4. 常见问题排查
4.1 路径拼写错误
这是最常见的问题之一。特别注意：
gazebo-classic中间有连字符sitl_gazebo-classic是下划线加连字符的组合- 路径区分大小写
4.2 执行顺序问题
务必确保命令的执行顺序：
- 先
source setup_gazebo.bash - 再设置
ROS_PACKAGE_PATH
如果顺序颠倒，可能会导致部分环境变量未被正确设置。
4.3 工作目录错误
所有命令都假设你在PX4-Autopilot的根目录下执行。如果不在正确目录，$(pwd)会指向错误的位置。可以通过pwd命令确认当前目录，或者直接使用绝对路径。
4.4 版本不匹配问题
如果你使用的是较旧的PX4版本，可能需要调整路径。可以通过以下命令检查PX4版本：
git log -1 --format=%cd --date=short对于2023年5月之前的版本，可能需要使用旧的路径配置。
5. 深入理解环境变量配置
5.1 ROS_PACKAGE_PATH的作用
ROS_PACKAGE_PATH是ROS系统中非常重要的环境变量，它告诉ROS去哪里查找软件包。当我们开发PX4的ROS相关功能时，需要确保：
- PX4的主目录在
ROS_PACKAGE_PATH中 - Gazebo仿真相关的插件目录也在
ROS_PACKAGE_PATH中
这就是为什么我们需要两条export命令来分别添加这两个路径。
5.2 setup_gazebo.bash的功能
这个脚本主要完成以下工作：
- 设置
GAZEBO_PLUGIN_PATH：告诉Gazebo在哪里查找PX4的插件 - 设置
GAZEBO_MODEL_PATH：告诉Gazebo在哪里查找PX4的模型 - 设置
LD_LIBRARY_PATH：确保Gazebo能找到PX4的共享库
如果不先执行这个脚本，后续的ROS启动可能会因为缺少这些关键配置而失败。
6. 自动化配置脚本推荐
为了简化配置过程，我通常会创建一个简单的bash脚本来自动化这个过程。在PX4-Autopilot根目录下创建setup_env.sh：
#!/bin/bash # 获取当前绝对路径 PX4_DIR=$(pwd) # 检查是否在PX4-Autopilot目录下 if [[ ! -f "${PX4_DIR}/Tools/simulation/gazebo-classic/setup_gazebo.bash" ]]; then echo "错误：请在PX4-Autopilot根目录下执行此脚本" exit 1 fi # 设置环境变量 source "${PX4_DIR}/Tools/simulation/gazebo-classic/setup_gazebo.bash" "${PX4_DIR}" "${PX4_DIR}/build/px4_sitl_default" export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:"${PX4_DIR}" export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:"${PX4_DIR}/Tools/simulation/gazebo-classic/sitl_gazebo-classic" echo "PX4 Gazebo环境配置完成！"给脚本添加执行权限：
chmod +x setup_env.sh以后每次需要配置环境时，只需执行：
./setup_env.sh7. 与ROS工作空间的集成
如果你使用自己的ROS工作空间开发PX4相关功能，还需要注意工作空间与PX4目录的集成。通常的做法是在catkin工作空间的src目录下创建PX4的符号链接：
ln -s ~/PX4-Autopilot ~/catkin_ws/src/PX4-Autopilot然后在.bashrc中先source你的ROS工作空间，再source PX4的配置：
# ROS工作空间配置 source ~/catkin_ws/devel/setup.bash # PX4配置 source ~/PX4-Autopilot/Tools/simulation/gazebo-classic/setup_gazebo.bash ~/PX4-Autopilot ~/PX4-Autopilot/build/px4_sitl_default export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:~/PX4-Autopilot export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:~/PX4-Autopilot/Tools/simulation/gazebo-classic/sitl_gazebo-classic这种配置方式既能保持PX4代码的独立性，又能让ROS工作空间正确识别PX4的软件包。
