Gentoo
上游官方架构
成品发行版
需要动手能力
先说结论
老手友好、新手劝退：文档齐全但全手工安装，适合想深度定制或做嵌入式 rootfs 的人。
- 基于
- 独立（源码构建，OpenRC/systemd 可选）
- 上游状态
- 官方架构：ARCH=riscv，~riscv keyword，release engineering 出 rv64gc/rv32gc stage3（lp64d/lp64/multilib、openrc/systemd、glibc/musl 全组合）；官方明确暂无 stable keyword 计划。
- 版本
- rolling（stage3 rv64_lp64d-openrc 20261026T164559Z）
- 文档语言
- en
- 核查日期
- 2026-11-01
支持的开发板
- QEMU virt 虚拟机型 官方支持 qemu-system-riscv64 与 qemu-riscv64 user-mode 均可；官方 wiki 有专门 QEMU 安装页
- SiFive HiFive Unmatched 社区可用 社区成员持有并在 wiki 硬件清单登记（SiFive FU740）
- StarFive VisionFive 2 社区可用 JH7110，wiki 标注 Active / 上游内核跟进
- 荔枝派 4A（LicheePi 4A） 社区可用 TH1520（C910），社区登记可跑标准安装
- Milk-V Pioneer（SG2042 服务器向） 社区可用 Milk-V Pioneer Box（SG2042，64 核）有开发者实机
- Orange Pi RV2（Ky X1） 社区可用 Ky X1（X60），社区登记
- Banana Pi BPI-F3（SpacemiT K1） 社区可用 SpacemiT K1（RVV 1.0），社区登记
下载
安装文档与视频
坑
- 只有 ~riscv（测试）keyword，没有 stable，装完要长期接受 unstable 包
- 不提供可直接烧写的镜像，必须走 stage3 手工安装（官方 TODO 里仍写着要做 bootable image）
- rv32 在 qemu user-mode 下仍有 bug，交叉/模拟测试会踩坑
- multilib 与 lp64d/lp64 ABI 混用容易装错 stage3，需先确认板子是否带 D 扩展
RuyiSDK 实测报告1
RuyiSDK 在真机上逐块板测过的记录，点开报告能看完整安装步骤与结论。
| 支持的开发板 | 状态 | 版本 | 最近测试 | 报告 |
|---|---|---|---|---|
| StarFive VisionFive 2 | ◐ 基本可用 | 2.13 | 2024-06-21 | 查看报告 |
状态含义：good 完整可用（能进桌面）、basic 基本可用（串口能起来）、part 部分功能、cft 有镜像待验证、cfh 文档称支持但启动失败、cfi 官方称支持但无镜像、wip 只有宣称。
出处6
- gentoo.org/downloads/riscv/
- distfiles.gentoo.org/releases/riscv/autobuilds/current-stage3-rv64_lp64d-openrc/
- wiki.gentoo.org/wiki/Project:RISC-V
- wiki.gentoo.org/wiki/RISC-V_Qemu_setup
- matrix.ruyisdk.org/reports/VisionFive2/Gentoo/README/
- matrix.ruyisdk.org/
完整来源清单与判定方法见 来源与致谢