Spike RISC-V 模拟器安装指南：三步完成编译与首次运行验证

Spike RISC-V 模拟器安装指南：三步完成编译与首次运行验证

【免费下载链接】riscv-isa-simSpike, a RISC-V ISA Simulator项目地址: https://gitcode.com/GitHub_Trending/ri/riscv-isa-sim

Spike 是一款 RISC-V 指令集模拟器，它以功能模型的方式逐条模拟一个或多个 RISC-V 处理器核（hart）的指令行为，覆盖 RV32/RV64 基础指令集及 M、A、F、D、C、V 等常用扩展。本文以 Linux 主机为例，带你走通 Spike 的依赖准备、源码编译安装和最小化运行验证，并整理一份按“现象—原因—处理”组织的卡点清单。按文中的命令顺序操作，大约 15~30 分钟内可以完成从克隆仓库到跑通示例程序的全过程。

安装前准备

动手前先对照下表核对环境。表格中的要求均来自仓库自带的configure检查逻辑（见 configure.ac），缺哪一项就补哪一项，不用全部预装。

在 Debian/Ubuntu 系统上，依赖安装命令如下（第二行可按需跳过）：

sudo apt-get install device-tree-compiler sudo apt-get install libboost-regex-dev libboost-system-dev

使用yum系发行版时，可用yum install dtc替代第一条命令。

源码获取与编译

将RISCV环境变量设为工具链安装目录，仓库文档默认使用这一约定：

git clone https://gitcode.com/GitHub_Trending/ri/riscv-isa-sim cd riscv-isa-sim export RISCV=/opt/riscv

Spike 采用外部构建目录，避免把编译产物混入源码树：

mkdir -p build && cd build ../configure --prefix=$RISCV make sudo make install

构建成功后，$RISCV/bin下会生成spike主程序和spike-dasm反汇编工具。如果不想使用sudo，可以把--prefix指向用户目录（例如~/riscv），后续再把$prefix/bin加入PATH：

export PATH=$PATH:$RISCV/bin

首次运行验证

先做一次不依赖工具链的冒烟检查。构建目录下的可执行文件可以直接查看版本横幅：

./build/spike --help

输出首行应显示Spike RISC-V ISA Simulator及版本号，说明核心构建成功。

完整的端到端验证需要一个能编译出 RISC-V ELF 的工具链（riscv-gnu-toolchain）和代理内核riscv-pk。示例程序保持最小化：

#include <stdio.h> int main(void) { printf("hello from spike\n"); return 0; }

编译并交由 Spike 模拟执行：

riscv64-unknown-elf-gcc -o hello hello.c spike pk hello

✅ 终端中打印出hello from spike后，即可确认 Spike RISC-V 模拟器的安装、配置与 ELF 加载链路全部可用。

常见报错定位

遇到卡点时，按下表对照处理，大多数问题出在依赖和权限两类环节。

进阶方向

验证通过后，可以按需求选择以下方向深入，此处只做索引，不展开细节。

• 交互式调试：加-d参数进入调试模式（spike -d pk hello），可用: reg 0 a0查看整数寄存器、: mem 2020查看物理内存、回车单步执行。
• 执行日志：-l生成执行日志，配合--log=<name>指定日志文件名。
• 内存与核数配置：-m<n>设定目标内存（MiB），-p<n>设定模拟的处理器核数量，--priv控制可用特权级。
• 自定义指令扩展：在riscv/insns/下按现有指令的写法描述新指令功能，在riscv/opcodes.h登记操作码，再把它加入riscv/riscv.mk.in参与构建；RoCC 方式则通过--extension与--extlib挂载动态库，参考 customext/ 目录中的示例。

资料入口

• 官方说明：README.md（构建步骤、调试用法均以它为准）
• 版本变更记录：ChangeLog.md
• 指令实现参考目录：riscv/insns/
• 测试样例：ci-tests/

下一步建议：先用-l参数重新跑一遍spike pk hello，观察指令级日志格式；随后尝试-p 2双核运行，熟悉多 hart 场景下的输出差异。

【免费下载链接】riscv-isa-simSpike, a RISC-V ISA Simulator项目地址: https://gitcode.com/GitHub_Trending/ri/riscv-isa-sim