Ruffle：用 Rust 本地播放 SWF 的 Flash 模拟器
项目地址: https://gitcode.com/GitHub_Trending/ru/ruffle 手里的 .swf 文件双击没反应、浏览器也不支持了，Flash Player 停服之后它们就成了只能看、打不开的存档。Ruffle 是一个用 Rust 重写的 Adobe Flash Player 模拟器，桌面版可以直接在本机播放 .swf 文件，画面、声音和鼠标键盘交互都能还原。Windows、macOS、Linux 三个平台都有桌面版，本地播放选它就对了。
📦 安装 Ruffle 桌面版并跑起来
按你的系统选一条路走，全程不需要自己编译：
- Windows：从项目发布页下载 nightly 预编译包，安装后启动即可。
- macOS：用 Homebrew 一条命令装好：
brew install --HEAD ruffle-rs/ruffle/ruffle
- Linux：Arch 系可用 AUR 包
ruffle-nightly-bin，其他发行版从 Flathub 安装rs.ruffle.Ruffle，仓库里 desktop/packages/linux/ 附了 AUR 与 Flatpak 的打包配置。
装好后在终端跑一次下面的命令确认二进制可用：
ruffle --version
能打印版本号就说明装好了，直接启动 ruffle 会打开播放器主窗口，接下来往里面放文件就行。
🚀 第一次播放 SWF 文件：拖进去就能跑
打开文件的最短路径：把 .swf 文件直接拖进 Ruffle 窗口，文件加载后立刻开始播放，不需要任何额外配置。此时你应该看到窗口顶部的菜单栏、中间的游戏画面和左下角的音量按钮。
日常操作只需要记住五个键：
| 操作 | 快捷键 |
|---|---|
| 全屏 | F11（Windows 也可 Alt+Enter） |
| 打开文件 | Ctrl/Cmd+O |
| 打开"文件/URL"对话框 | Ctrl/Cmd+Shift+O |
| 暂停/继续 | Ctrl/Cmd+P |
| 单帧步进 | Ctrl/Cmd+空格 |
⚙️ 进阶配置：换图形后端、降功耗、传启动参数
换图形后端解决黑屏。播放时出现黑屏、渲染错误，多半是默认图形后端和显卡驱动不合。用 -g（等价于 --graphics）指定后端，可选 vulkan、metal、dx12、gl：
ruffle test.swf -g vulkan
降功耗解决卡顿。Ruffle 默认偏好高性能独显，有些笔记本上核显反而更稳。加 --power low 强制走低功耗显卡，它和 -g 可以组合使用：
ruffle test.swf -g vulkan --power low
给老游戏传启动参数。吃 flashvars 的老游戏，用 -P key=value 在命令行传参，可以重复传多个；想要启动即全屏就再补一个 --fullscreen：
ruffle test.swf -P score=100 -P name=player --fullscreen
源码构建。需要最新修复或者想参与贡献时才走这条路，依赖最新稳定版 Rust 和 Java（编译内置 ActionScript 3 类库要用到 java）。Linux 上再补一批系统库：
sudo apt install pkg-config libasound2-dev libudev-dev libfontconfig-dev libfreetype6-dev libssl-dev default-jre-headless g++
克隆仓库后编译运行，第一次构建会比较久：
git clone https://gitcode.com/GitHub_Trending/ru/ruffle
cargo run --release --package=ruffle_desktop -- test.swf
🧭 Ruffle 本地播放能做到什么、做不了什么
| 能力项 | 现状 |
|---|---|
| ActionScript 1/2/3 | 支持得相当好，但没做完，个别老特性缺失或行为不一致 |
| 播放范围 | 桌面版只管本地播放，网页版和浏览器扩展是独立组件 |
| 外部网络 | 受沙箱约束，限制比当年的 Flash Player 更严 |
| 脚本执行 | 有超时上限，死循环脚本到点会被暂停，不会拖死播放器 |
🩹 播放出问题先查这几条
- 拖进去打不开：先查文件本身。从网页另存下来的 .swf 经常其实是 .zip 或 .html，用 Ctrl/Cmd+Shift+O 对话框手动填路径试试，还是打不开就不是播放器的事。
- 黑屏、渲染错误、画面撕裂：先加
-g vulkan或-g gl换个后端重启，这是命中率最高的一招。 - 播放卡顿：多半卡在独显上，加
--power low强制核显再试。 - 没有声音：Ruffle 走系统音频 API 出声，先确认系统默认播放设备本身是好的，再回来怀疑播放器。
🧰 顺手带走几个批量工具
手里攒了一堆 .swf 想先批量确认哪些能解析，用仓库里的 scanner/ 工具：给一个文件夹路径，扫完输出 CSV 报告。只想把几个 SWF 截成 PNG 存档，用 exporter/ 工具，命令行带文件路径即可。功能缺失或者行为不对，去项目 issue 区反馈，附上出问题的 .swf 文件和复现步骤。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
