✅ 一、仓库简介

仓库地址：https://github.com/riscv/riscv-opcodes ([GitHub][1])
功能：
- 列出所有标准的 RISC-V 指令编码（opcode）与控制状态寄存器（CSR）编码。 ([GitHub][1])
- 提供脚本（Python）用于将这些编码生成多种形式的“制品”——像 C 头文件 (encoding.h)、LaTeX 表格、SystemVerilog 解码器代码、Rust、Go 等。 ([GitHub][1])
授权：BSD-3-Clause License ([GitHub][1])
用途：可用于实现 RISC-V 模拟器（如 Spike）、工具链、CPU 解码器、汇编器／反汇编器、研究等。

🔧 二、快速上手步骤

克隆仓库

bash

git clone https://github.com/riscv/riscv-opcodes.git
cd riscv-opcodes

安装依赖 这个项目使用 Python 脚本 parse.py 来解析指令编码，并使用 make 生成多种格式。你可能需要安装 Python、Make、Rust/Go 等工具（视你要生成哪种“制品”）。仓库 README 中说明了这一点。 ([GitHub][1])
生成 artifacts（制品） 在根目录执行：
bash
```
make
```
默认会生成多种输出，比如 encoding.out.h, inst.sverilog, instr-table.tex 等。 ([GitHub][1]) 如果只想生成特定格式或者只想特定扩展，可以用：
bash
```
make EXTENSIONS='rv*_i rv*_m'
```
表示你只选择 I 和 M 扩展。 ([GitHub][1])
查找某条指令编码 你可以在源码中搜索，比如：
bash
```
grep "^\s*add " extensions/rv*_i
```
或者生成 instr_dict.json 后用 JSON 工具查找。 ([GitHub][1])

如果你需要添加自定义扩展或特定指令集支持：

在 extensions/ 或 extensions/unratified/ 目录中创建一个新的 rv_xxx 文件。文件命名有规则：
- rv_x：通用于 32/64 位模式的扩展。
- rv32_x：只适用于 RV32 的扩展。
- rv64_x：只适用于 RV64 的扩展。
- rv_x_y：当指令同时依赖扩展 X 和 Y 时。 ([GitHub][1])
在文件中按照编码语法定义指令。语法包括 bit-range 指定、变量参数、伪操作符 $pseudo_op, 导入 $import 等。 ([GitHub][1])
运行 make 检查所有定义是否合法；如果报错，可查看 parse.py 的日志。
提交 Pull Request 合入官方仓库时请注意遵守命名规则和贡献流程。 ([GitHub][1])

如果你在开发 RISC-V 模拟器／汇编器／反汇编器／调试器，这个仓库提供了官方编码表，是重要参考。
如果你需要 理解或验证指令编码，比如 decoding 来自内存的 32 位指令，这里生成的 encoding.h、inst.sverilog 是有价值的。
虽然你偏软件系统层面（操作系统、编译器、系统调用等），但理解指令编码、CSR 编号、控制位等会帮助你更准确地与底层架构对接。