开发者指南

GNU 工具链

GCC 及 Binutils 已正式支持龙架构，您可以通过发行版仓库直接安装、下载二进制或交叉编译等方式安装该工具链。

如下是在几个常见 Linux 发行版和操作系统下安装 GNU 工具链的方法：

如果您没有龙架构设备或希望交叉编译：

LLVM 工具链

LLVM 已正式支持龙架构，您可以通过发行版仓库直接安装、下载二进制或交叉编译等方式安装该工具链。

如下是在几个常见 Linux 发行版和操作系统下安装 LLVM 工具链（含 Clang）的方法：

LLVM 工具链（尤其是 Clang 编译器）原生支持交叉编译，使用 LLVM 17 或更新版本并参考本文指定龙架构目标（如 loongarch64-unknown-linux-gnu）即可为龙架构交叉编译该工具链。

Rust

Rust 已正式支持龙架构，您可以通过发行版仓库直接安装、下载二进制或交叉编译等方式安装该工具链。

Rust 官方推荐使用 rustup 安装 Rust 工具链：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

如下是在几个常见 Linux 发行版和操作系统下安装 Rust (rustc) 及 Cargo 包管理器的方法：

Node.js

Node.js 已正式支持龙架构，您可以通过发行版仓库直接安装、下载二进制或交叉编译等方式安装该工具链。目前 Node.js 通过 Unofficial Builds 项目提供龙架构二进制，从该页面下载 loong64 标记的工具链包即可直接使用。

如下是在几个常见 Linux 发行版和操作系统下安装 Node.js 的方法：

Go

Go 已正式支持龙架构，您可以通过发行版仓库直接安装、下载二进制或交叉编译等方式安装该工具链。目前 Go 官方已开始提供龙架构二进制，您可以通过其下载页面下载。

如下是在几个常见 Linux 发行版和操作系统下安装 Go 工具链的方法：

Go 工具链原生支持交叉编译，使用 Go 1.21 或更新版本并参考本文指定龙架构目标（即 GOARCH=loong64）即可为龙架构交叉编译该工具链。

Python

Python 已正式支持龙架构，您可以通过发行版仓库直接安装、下载二进制或交叉编译等方式安装该工具链。

如下是在几个常见 Linux 发行版和操作系统下安装 Python 的方法：

.NET

.NET 已正式支持龙架构，但由于龙架构属于 .NET 的“社区支持架构 (community-supported architecture)”，微软官方不提供其二进制工具链。

您可以通过以下途径获取 .NET 工具链二进制：

• .NET 10（来自龙芯中科）
• .NET 9（来自 loongson-community 组织）

对于常见的 Linux 发行版，选择 RID（.NET 运行时标识符）为 linux-loongarch64 的 SDK 包即可获取完整工具链。如 dotnet-runtime-10.0.1-linux-loongarch64.tar.gz；关于如何使用 tar 包安装 .NET SDK，参阅 .NET 官方文档

为龙架构交叉编译 .NET 程序 ​

.NET 原生支持交叉编译和跨平台发布，使用 .NET 9 以上版本并参考本文指定目标 RID 后即可为龙架构发布 .NET 程序，但由于龙架构属于 .NET 的“社区支持架构”，NuGet.org 不提供目标为龙架构的 .NET 运行时包，在构建过程中会因此失败。

目前可以通过本地提供相应 NuGet 包的方式规避：

从上文获取工具链的位置获取以下文件（*号为具体的版本号）：

• Microsoft.AspNetCore.App.Runtime.linux-loongarch64.*.nupkg
• Microsoft.NETCore.App.Crossgen2.linux-loongarch64.*.nupkg
• Microsoft.NETCore.App.Host.linux-loongarch64.*.nupkg
• Microsoft.NETCore.App.Runtime.linux-loongarch64.*.nupkg
• runtime.linux-loongarch64.Microsoft.DotNet.ILCompiler.*.nupkg

将上述文件放入符合您需要的路径（如/data/loongarch64-nupkgs）并参考本文将该目录加入 NuGet 源列表，如下所示：

<packageSources>
    <add key="LoongArch64 Packages" value="/data/loongarch64-nupkgs" />
</packageSources>

方能交叉编译龙架构 .NET 程序。

编译 .NET 工具链 ​

.NET 工具链本身的编译较为复杂，建议参考龙芯中科使用的 CI 构建脚本；该方式使用 .NET 官方推荐的 VMR 源码发行包进行编译。

Java

由于非技术原因，Oracle OpenJDK 暂未支持龙架构 JIT。要安装 Java 工具链，目前推荐通过各 Linux 发行版或通过“龙芯开源社区 (loongnix.cn)” 下载“兼容 Linux 5.10.0 内核 UAPI”的二进制包。

如下是在几个常见 Linux 发行版和操作系统下安装 Java 工具链的方法：

Linux 内核

上游 Linux 内核已正式支持龙架构。一般来说，基于 ABI2.0 的 Linux 发行版均使用上游内核（外加平台规避等补丁，见下文参考），但也有部分商业性质的发行版会选用 6.6 内核并附加大量平台支持补丁。

内核维护参考 ​

如前文所说，对于龙架构设备来说，Linux 内核是越新越好的。但考虑到 Linux 发行版有具体的维护规则和需要，如下是对 Linux 大版本更新对应的平台支持的说明：

未上游补丁 ​

长期以来，龙架构内核维护及新平台支持均有推送主线，但由于种种技术和非技术原因，部分龙架构功能相关的补丁仍未能上游化。

下表中列出了目前已知的、正在各下游（开发者、发行版社区等）维护的必要支持补丁，供各位参考（补丁列表及代码基于 v6.19-rc1 技术状态，不包含已经提交到上游 loongarch 邮件列表的补丁）：

Docker

Docker 软件已正式支持龙架构，您可以通过 Linux 发行版软件源安装；如下是在几个常见 Linux 发行版和操作系统下安装 Docker 的方法：

CI 代理 (Runner)

诸多代码托管平台均有提供 CI 代理 (Runner) 支持，其中已有一部分支持龙架构。

GitHub Actions ​

目前 GitHub Actions Runner 由于 NuGet 缺少龙架构支持，暂时无法推进二进制发布。如希望自行编译部署该 CI 代理，可参考此拉取请求。

GitLab Runner ​

GitLab Runner 已正式支持龙架构，可通过其发布页面下载 loong64 标记的软件包或压缩包，直接安装使用。

Gitea act_runner ​

Gitea act_runner 已正式支持龙架构，但暂未提供龙架构二进制，目前可拉取源代码自行编译部署。

Forgejo Runner ​

Forgejo Runner 暂未合入龙架构支持，如希望自行编译部署该 CI 代理，可参考此拉取请求。

Sourcehut ​

Sourcehut 的 CI 代理 builds.sr.ht 已正式支持龙架构。该 CI 代理不发布二进制，您可以自行拉取代码编译部署。

Gitee ​

Gitee 暂未合入龙架构支持，可参考如下拉取请求的代码自行编译部署：

• gitee-go/utils#1
• gitee-go/core#1
• gitee-go/runner-core#1
• gitee-go/runner#1

GitCode ​

据社区好友咨询，GitCode 暂未支持自建 CI 代理，暂时无法支持龙架构。