首页/系统/信创系统运维速查/龙芯 LoongArch 平台要点
迁移适配65 条

龙芯 LoongArch 平台要点

龙芯新平台(3A5000/3A6000)为 LoongArch64:二进制与软件包须 loongarch64 版本;老 3A4000 及更早为 MIPS,两代体系不可混用。

信创系统运维速查系统更新于 2026-10-13

两代龙芯平台的差别

龙芯处理器存在两代相互不兼容的指令集体系:3A4000 及更早的型号属于 MIPS 体系,3A5000、3A6000 等新一代产品使用自主的 LoongArch 架构。两者的软件包、二进制程序与运行时库都不能通用,把 MIPS 时代的迁移经验直接套到新平台上,是适配阶段最常见的踩坑点。

为什么系统镜像必须匹配

发行版为不同架构各自出包,仓库地址与包后缀都不同。用错架构的安装介质或仓库,会出现软件包无法安装、安装后程序报格式错误、动态库找不到等现象。排查时第一步不是看依赖,而是确认机器架构与所装软件包的架构是否一致。

基本信息

新平台架构loongarch64,对应 3A5000、3A6000 等型号
旧平台架构mips64el,对应 3A4000 及更早型号
确认命令uname -m、lscpu、rpm -qp --qf 查包架构
软件来源发行版 loongarch64 仓库,或厂商发布的对应版本

典型使用场景

  • 新到货整机做交付验收,核对架构与操作系统镜像是否匹配
  • 业务系统迁移前评估目标平台能提供哪些软件包
  • 排查二进制程序启动即报格式错误,确认是否是架构不符
  • 编写适配清单时区分两代平台的结论,避免复用错误经验
  • 采购前向厂商确认闭源软件是否已有该架构的正式版本

确认架构与包匹配

确认架构与包匹配
uname -m                       # loongarch64 为新平台,mips64el 为旧平台
lscpu | head -15               # 型号与核心信息
cat /etc/os-release | head -5  # 系统版本,用于对齐仓库
file /opt/app/bin/app          # 二进制文件的架构标识
rpm -qp --qf '%{ARCH}\n' pkg.rpm   # 待安装包的目标架构

仓库与依赖核对

仓库与依赖核对
grep -hE 'name=|baseurl=' /etc/yum.repos.d/*.repo | head
rpm -qa --qf '%{NAME} %{ARCH}\n' | grep -v loongarch64 | head   # 找出架构异常的包
ldd /opt/app/bin/app | grep -i 'not found'                      # 缺库时核对是否架构不符

现象与判断

现象可能原因验证方法
程序报无法执行二进制文件二进制架构与机器不符file 查看文件架构标识
软件包无法安装包架构与系统不匹配rpm -qp 查包架构
提示共享库找不到库为其他架构或未安装ldd 结合包架构逐项核对
能装但运行异常使用了旧架构的兼容包核对依赖链上的库架构是否统一
仓库下载即失败仓库地址指向其他架构检查 repo 文件中的架构路径
生态适配进度因架构与应用而异:部分闭源软件需要厂商发布 loongarch64 版本,或改用功能相当的替代方案,排期之前先拿到书面适配结论,避免先承诺后返工。

易错点

  • 把 MIPS 时代的适配经验套用到 LoongArch,包与二进制全部要按新架构重新准备
  • 只核对操作系统版本不核对架构,镜像装完才发现软件包体系完全不同
  • 闭源软件的架构覆盖情况没提前确认就排期,上线前才发现没有可用版本
  • 依赖链上混入其他架构的库文件,程序能启动但运行中随机崩溃,排查成本很高

数据来源与参考

  • 龙芯中科公开技术资料
  • LoongArch 官方文档(公开)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌