MSXBAS2ROM：MSX-BASIC 转 ROM 编译器

项目简介

MSXBAS2ROM 是一个用 C++ 开发的开源、跨平台 MSX-BASIC 编译器，以命令行工具（CLI）的形式提供。它可以把纯文本的 MSX-BASIC 程序编译成 ROM 文件，用于在模拟器或真实 MSX 硬件上运行。

工具在终端中执行，也便于接入各种开发环境，让开发者自行掌控把 MSX-BASIC 程序打包成 ROM 的过程。

主要功能

• 将 .bas 形式的 MSX-BASIC 源码编译为 ROM 文件
• 跨平台：提供 Linux、Windows（32 位与 64 位）和 macOS 的二进制与安装包
• 支持通过命令行参数调整编译选项
• 内置版本查询与参考文档输出
• 项目规格、需求与架构决策以 OpenSpec 格式维护在仓库的 openspec/ 目录中，涵盖 lexer、parser、compiler、builder、CLI 等能力说明

安装与使用

在项目的 releases 页面可以找到适用于 Linux、Windows（32/64 位）和 macOS 的二进制与安装包，详细的安装步骤见 wiki 的 Installation 页面。

编译一个 MSX-BASIC 程序：

msxbas2rom test.bas

不带参数运行可查看更多编译选项：

msxbas2rom

查看当前版本与参考指南：

msxbas2rom -v
msxbas2rom --doc

生成的 ROM 可以放到模拟器中测试，例如 WebMSX 或 OpenMSX。更多用法见 wiki 的 Getting Started 页面。

注意事项

• 项目使用 GPL-3.0 许可证。
• 编译结果是 ROM 文件，需要配合 MSX 模拟器或真实 MSX 硬件运行，不能直接在普通 PC 上执行。
• 想了解项目架构与编译流程的开发者，可先阅读仓库中的 doc/misc/architecture.md，其中说明了分层架构、端到端编译管线，以及 Z80 kernel 如何构建并打包进 ROM。

本作品整理自 GitHub 开源项目 amaurycarvalho/msxbas2rom，原作者 @amaurycarvalho，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。