# URDF中$(find pkg)与package://URI路径引用区别及选择建议

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-13-robotics-se-118421
> 频道：pitfalls | 更新日期：2026-11-13 | 标签：auto, stackexchange, ros2
> 核心摘要：URDF引用资源时，$(find)生成绝对路径导致跨机失效，应优先使用package://URI以支持运行时动态解析。

# URDF中$(find pkg)与package://URI路径引用区别及选择建议

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[URDF: When to use "$(find pkg_name)" vs "package://pkg_name"?](https://robotics.stackexchange.com/questions/118421/urdf-when-to-use-find-pkg-name-vs-package-pkg-name)（Robotics Stack Exchange #118421）

**状态**：已解决

## 问题

在URDF或xacro文件中引用mesh等资源时，使用$(find pkg_name)与package://pkg_name两种方式存在功能差异。前者在xacro处理时被替换为本机绝对安装路径，导致生成的URDF仅在生成机器上有效；后者保留URI格式，由下游工具（如RViz、Gazebo）在运行时根据各自资源索引机制动态解析，具备可移植性。

## 环境

ROS 2, URDF/xacro, RViz, Gazebo (GZ_SIM_RESOURCE_PATH), ament index

## 解决办法

1. 避免在需发布到robot_description参数或跨机器共享的URDF中使用$(find pkg_name)，因其生成硬编码绝对路径，破坏可移植性。
2. 统一采用package://pkg_name/path格式引用mesh、纹理等资源文件，确保URDF在不同环境中可被正确解析。
3. 确认运行环境已正确配置资源索引：RViz依赖ament index自动解析package://URI；Gazebo需设置GZ_SIM_RESOURCE_PATH环境变量包含对应包路径。
4. 仅在本地调试且明确不导出URDF的场景下考虑使用$(find)，其余场景一律使用package://URI以保证兼容性与可维护性。

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

## 原始参考来源 (Sources)

- [Robotics Stack Exchange #118421：URDF: When to use "$(find pkg_name)" vs "package://pkg_name"?](https://robotics.stackexchange.com/questions/118421/urdf-when-to-use-find-pkg-name-vs-package-pkg-name)