# unitree_sdk2_python中CYCLONEDDS_HOME路径引用错误导致安装失败

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-02-26-unitree-sdk2-python-131
> 频道：pitfalls | 更新日期：2026-02-26 | 标签：auto, github-issue, unitree_sdk2_python
> 核心摘要：文档中CYCLONEDDS_HOME使用波浪号加引号导致路径解析错误，改用$HOME变量或去除引号即可修复。

# unitree_sdk2_python中CYCLONEDDS_HOME路径引用错误导致安装失败

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[The export path for exporting CYCLONEDDS_HOME is referenced to use a path which does not point to $HOME as is intended](https://github.com/unitreerobotics/unitree_sdk2_python/issues/131)（GitHub unitreerobotics/unitree_sdk2_python #131）

**状态**：已解决

## 问题

unitree_sdk2_python README.md 文档中 `export CYCLONEDDS_HOME="~/cyclonedds/install"` 写法错误，双引号包裹的波浪号 `~` 不会被 Shell 展开为用户主目录，导致后续 pip 安装时无法定位 CycloneDDS 依赖路径。

## 环境

unitree_sdk2_python SDK，Linux 环境，CycloneDDS 依赖库

## 解决办法

1. 将环境变量设置修改为 `export CYCLONEDDS_HOME="$HOME/cyclonedds/install"`，使用 `$HOME` 变量确保路径正确展开。
2. 或者保留波浪号但去除双引号，执行 `export CYCLONEDDS_HOME=~/cyclonedds/install`，使 Shell 自动展开 `~`。
3. 修正路径后重新执行 `pip3 install -e .` 完成 SDK 安装。

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

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/unitree_sdk2_python #131：The export path for exporting CYCLONEDDS_HOME is referenced to use a path which does not point to $HOME as is intended](https://github.com/unitreerobotics/unitree_sdk2_python/issues/131)