银河麒麟系统依赖错误应先确认Debian系或RPM系系统类型，再分别执行修复破损依赖、清理缓存并刷新源索引、手动安装架构匹配库、用gdebi/aptitude替代dpkg安装deb包。
在麒麟OS上安装软件时遇到“依赖关系不满足”“无法定位软件包”“缺少libxxx.so”等报错，说明系统无法自动获取或解析所需依赖项，必须人工介入识别来源、清理状态、匹配架构并补全链路。
第一步：确认系统类型与包管理器
银河麒麟OS分Debian系（如桌面版V10 SP1基于Ubuntu 20.04）和RPM系（如服务器版V10基于openEuler），混用apt和dnf会导致命令无响应或报错“command not found”。
执行：cat /etc/os-release
查看输出中是否含Ubuntu或Debian——有则为Debian系，用apt；若含openEuler【Kylin Server】或CentOS，则属RPM系，必须用dnf或yum。
第二步：强制修复破损依赖状态
适用于dpkg强制中断、断电后重启、手动安装deb/rpm导致APT数据库断裂的场景。此操作会重装缺失包、回滚冲突版本、清除半配置状态。
Debian系执行：sudo apt-get --fix-broken install
RPM系执行：sudo dnf distro-sync --best --allowerasing
执行后立即运行sudo apt-get check（Debian系）或sudo dnf repoquery --unsatisfied（RPM系）验证是否清零报错。
第三步：清理缓存并刷新源索引
方法一：一键清理+强制更新
Debian系：sudo apt clean && sudo apt update --fix-missing
RPM系：sudo dnf clean all && sudo dnf makecache --refresh
方法二：切换国内镜像源（当出现“Failed to fetch”或“Hash Sum mismatch”时必做）
Debian系替换为阿里云源：sudo sed -i 's|archive.kylinos.cn|mirrors.aliyun.com/kylin|g' /etc/apt/sources.list
RPM系启用华为云源：sudo dnf config-manager --set-enabled huaweicloud
注意：修改源后必须再次执行sudo apt update或sudo dnf makecache，否则新源不生效。
第四步：手动安装缺失架构专用库
当报错明确指出库名与架构（如libpng16-16:aarch64、openssl-devel.loongarch64）时，不能靠apt install libpng16-16模糊匹配——默认源只提供amd64或通用包。
第一步：查清缺失库精确名称与目标架构
运行ldd /path/to/binary | grep "not found"或看报错原文，记下完整库名（含版本号和架构后缀）。
第二步：前往对应镜像站搜索下载
ARM64用户访问：https://www.php.cn/link/bcd9d4e04b0589678de37d36ff5f68c8
LoongArch用户访问：https://www.php.cn/link/1158bf1554583e16f7aad791a43f369a
第三步：安装下载的包
Debian系：sudo dpkg -i xxx.deb
RPM系：sudo rpm -ivh xxx.rpm
若提示“failed dependencies”，加--force-deps参数仅限紧急排障，【不可用于生产环境】。
第五步：用gdebi或aptitude替代dpkg安装deb包
当你双击.deb文件失败，或执行sudo dpkg -i xxx.deb后提示“依赖未满足”，说明dpkg只解包不拉依赖。
方法一：用gdebi自动补依赖
先安装工具：sudo apt install gdebi
再安装包：sudo gdebi xxx.deb
方法二：用aptitude交互选解法
安装工具：sudo apt install aptitude
执行安装：sudo aptitude install ./xxx.deb
当显示多个解决方案时，按n跳过默认方案，按g列出选项，选择标有Downgrade或Keep的低破坏性路径，按!确认执行。
