You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

树莓派(Raspbian Stretch)手动安装Azure CLI报错求助

解决树莓派Raspbian Stretch安装Azure CLI时的ffi.h缺失错误

我之前在树莓派上装Azure CLI也碰到过一模一样的问题!根源是你虽然已经安装了libffi,但系统缺了它的开发头文件包——编译Python的cffi依赖时必须要用到ffi.h这个头文件,而Raspbian默认只装了libffi的运行时库,没装开发组件。下面是一步步的解决方法:

  • 先更新系统源,然后安装缺失的开发包:

    sudo apt-get update
    sudo apt-get install libffi-dev libssl-dev
    

    顺便把libssl-dev也装上,确保openssl的开发组件也到位,避免后续出现类似的编译问题。

  • 清理之前安装失败留下的残留文件,防止干扰新的安装过程:

    rm -rf /home/pi/lib/azure-cli
    rm -rf /tmp/azure_cli_install_tmp_* /tmp/pip-*
    
  • 重新运行Azure CLI的安装脚本:

    curl -L https://aka.ms/InstallAzureCli | bash
    
  • 安装完成后,记得把Azure CLI的执行路径添加到你的shell配置文件里,这样每次登录都能直接使用az命令:

    echo 'export PATH="$HOME/lib/azure-cli/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc
    

为什么会出现这个错误?

ffi.h是libffi库的开发头文件,当安装脚本编译Python的cffi模块(Azure CLI的核心依赖之一)时,必须读取这个文件才能完成编译。Raspbian默认只安装了libffi的运行时库(不带-dev后缀),所以会触发找不到头文件的编译失败,安装libffi-dev就能补上这个缺失的关键组件。

内容的提问来源于stack exchange,提问作者iAmoric

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.12 03:52:07