https://github.com/bkm016/pervius
基于 Vineflower 的由 Rust 语言编写的现代化 Java 反编译与字节码编辑工具。
https://github.com/bkm016/pervius
eframe egui java-decompiler native-desktop-app rust
Last synced: 13 days ago
JSON representation
基于 Vineflower 的由 Rust 语言编写的现代化 Java 反编译与字节码编辑工具。
- Host: GitHub
- URL: https://github.com/bkm016/pervius
- Owner: Bkm016
- License: mit
- Created: 2026-04-08T19:37:33.000Z (19 days ago)
- Default Branch: master
- Last Pushed: 2026-04-12T04:18:15.000Z (16 days ago)
- Last Synced: 2026-04-12T05:21:33.295Z (16 days ago)
- Topics: eframe, egui, java-decompiler, native-desktop-app, rust
- Language: Rust
- Homepage:
- Size: 18.9 MB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pervius
**现代化的 Java 反编译与字节码编辑工具。**
[Vineflower](https://github.com/Vineflower/vineflower) 反编译 · [ClassForge](classforge/) 字节码重写 · Rust 原生界面
[](https://www.rust-lang.org/)
[](https://github.com/emilk/egui)
[](#运行要求)
[](LICENSE)
[](https://github.com/Vineflower/vineflower)
[](classforge/)
[特性](#特性) · [运行要求](#运行要求) · [构建](#构建) · [快捷键](#快捷键) · [项目结构](#项目结构)
## 特性
### 反编译
基于 Vineflower，支持 JAR 批量反编译和单文件按需反编译。小体积 JAR 自动全量反编译，大 JAR 按需逐类反编译。Vineflower 输出实时解析进度，逐类跟踪。结果按 JAR 的 SHA-256 缓存，重复打开不重编译。Kotlin 类自动检测并输出 `.kt`，保留原始行号映射。
### 字节码编辑
结构化 `.class` 编辑面板：左侧导航类信息、字段、方法，右侧对应编辑区。可修改访问标志、继承关系、注解、描述符，方法指令也可直接编辑。保存时 ClassForge（基于 ASM 9.7）自动处理常量池重建、StackMapTable 重算和 max_stack/max_locals。未修改方法直接字节拷贝，仅对改动方法触发帧重算。
### 三视图
每个 `.class` 可通过 `Tab` 在三种视图间切换：
- **反编译视图** — 语法高亮的 Java/Kotlin 源码，只读
- **字节码视图** — 结构化编辑面板
- **Hex 视图** — 交互式十六进制查看器
非 `.class` 的文本文件（XML、YAML、JSON 等）直接可编辑，带语法高亮；二进制文件以 Hex 视图打开。
### 代码导航
`Ctrl+Click`（macOS `Cmd+Click`）跳转到类、方法、字段的定义。支持 import 解析、同包推断和通配符匹配。在方法声明处 `Ctrl+Click` 触发 Find Usages，自动搜索所有引用。
### 全局搜索
`Double Shift` 打开搜索面板，覆盖所有反编译源码，支持正则和大小写敏感。结果流式返回，按类分组，行级高亮预览，双击跳转。反编译完成后后台自动建索引，不阻塞 UI。
### 归档浏览
左侧资源树展示 JAR 内容，支持 `jar` `zip` `war` `ear`。键入即过滤（Speed Search），过滤计算在后台线程完成。修改状态实时标记，反编译状态实时可见。支持拖拽打开和最近文件列表。
### 导出
- **导出 JAR**（`Ctrl+Shift+S`）— 修改写回 JAR，生成新归档
- **导出反编译源码**（`Ctrl+Shift+E`）— 导出 `.java`/`.kt` 到指定目录，保留包结构
## 运行要求
- 已配置 `JAVA_HOME`
Vineflower 和 ClassForge 已内置，首次运行自动释放到数据目录。如需覆盖，可在可执行文件同目录放置同名 JAR（优先级最高）。
## 构建
```bash
cargo build --release
```
ClassForge 和 Vineflower 已通过 `include_bytes!` 内置到二进制中，无需额外复制 JAR。
构建 ClassForge（仅需在修改 ClassForge 源码后重新执行）：
```bash
cd classforge
./gradlew jar # Windows: .\gradlew.bat jar
```
将产出的 JAR 复制到 `crates/pervius-java-bridge/libs/` 替换同名文件，重新编译 Rust 即可。
```bash
cargo run --release
```
## 快捷键
| 快捷键 | 操作 |
|:-------|:-----|
| `Ctrl+O` | 打开归档或单文件 |
| `Ctrl+S` | 保存 |
| `Ctrl+F` | 查找 |
| `Double Shift` | 全局搜索 |
| `Ctrl+Click` | 跳转到定义 / Find Usages |
| `Tab` | 切换视图 |
| `Alt+1` | 切换资源树 |
| `Ctrl+Shift+S` | 导出 JAR |
| `Ctrl+Shift+E` | 导出反编译源码 |
| `Ctrl+,` | 设置 |
所有快捷键可在设置中自定义。
## 致谢
- [Vineflower](https://github.com/Vineflower/vineflower) — Java 反编译引擎
- [ASM](https://asm.ow2.io/) — Java 字节码操作框架
- [egui](https://github.com/emilk/egui) — Rust immediate mode GUI
- [tree-sitter](https://tree-sitter.github.io/tree-sitter/) — 语法高亮
## 许可证
[MIT](LICENSE)