# pylibfranka构建wheel报错无法确定版本及缺失pinocchio依赖

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-09-15-libfranka-242
> 频道：pitfalls | 更新日期：2026-09-15 | 标签：auto, github-issue, libfranka
> 核心摘要：构建pylibfranka时因路径错误导致版本获取失败，升级pip后暴露pinocchio缺失问题，需从根目录安装并补装依赖。

# pylibfranka构建wheel报错无法确定版本及缺失pinocchio依赖

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Cannot buid pylibfranka wheel](https://github.com/frankarobotics/libfranka/issues/242)（GitHub frankaemika/libfranka #242）

**状态**：有绕过办法

## 问题

在pylibfranka子目录执行`pip install .`构建wheel时报错`RuntimeError: Could not determine libfranka version`，提示必须在libfranka源码树内构建。按建议切换至项目根目录安装并升级pip至26.2.1后，版本解析通过但构建中断，报错提示缺少`pinocchio`依赖，而该依赖未声明在`requirements.txt`或`setup.py`中。

## 环境

Python 3.10, pip 22.0.2（后升级至26.2.1）, setuptools 84.0.0, libfranka/pylibfranka源码仓库

## 解决办法

1. 进入libfranka项目根目录而非pylibfranka子目录执行安装命令`pip install ./pylibfranka`，确保`setup.py`能正确读取`CMakeLists.txt`中的版本号。
2. 执行`python3 -m pip install --upgrade pip`将pip升级至最新版本，解决旧版pip对PEP517构建后端的支持问题。
3. 手动安装缺失的构建依赖`pinocchio`，因该库仅在`CMakeLists.txt`中声明而未包含在Python包元数据中。
4. 若仍遇setuptools兼容性问题，尝试执行`pip install -U 'setuptools>=67.8'`升级构建工具链。

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

## 原始参考来源 (Sources)

- [GitHub frankaemika/libfranka #242：Cannot buid pylibfranka wheel](https://github.com/frankarobotics/libfranka/issues/242)