# ZED相机描述包依赖过重致Docker构建失败，需独立zed_description包

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-01-19-zed-ros2-wrapper-410
> 频道：pitfalls | 更新日期：2026-01-19 | 标签：auto, github-issue, zed-ros2-wrapper
> 核心摘要：原zed_wrapper包含驱动依赖导致纯描述场景Docker构建失败，官方已发布独立zed_description包解决。

# ZED相机描述包依赖过重致Docker构建失败，需独立zed_description包

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Make camera description a standalone-pkg](https://github.com/stereolabs/zed-ros2-wrapper/issues/410)（GitHub stereolabs/zed-ros2-wrapper #410）

**状态**：已解决

## 问题

在Docker容器中仅构建机器人描述时，`zed_wrapper`的`package.xml`强制依赖`zed_components`及图像传输插件，导致无需相机驱动的容器构建失败。用户请求将URDF/Mesh剥离为独立包，仅保留`zed_msgs`依赖以支持`rosdep`解析。

## 环境

ROS2 Humble/Jazzy/Rolling，ZED ROS2 Wrapper，Docker容器环境

## 解决办法

1. 停止使用`zed_wrapper`获取相机描述文件，改用官方独立仓库`zed-ros2-description`。
2. 通过apt安装新包`zed_description`（已索引至Humble、Jazzy和Rolling发行版）。
3. 更新xacro引用路径，注意Meshes和URDF资源已从`zed_msgs`包中移除并迁移至新包。
4. 在Dockerfile中使用`rosdep install zed_description`替代原驱动包依赖，避免拉取`zed_components`等运行时组件。

讨论原作者：@pucciland95 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub stereolabs/zed-ros2-wrapper #410：Make camera description a standalone-pkg](https://github.com/stereolabs/zed-ros2-wrapper/issues/410)