maru 的安装和配置教程

1. 项目的基础介绍和主要的编程语言

Maru 是一种自托管的小型 Lisp 方言，它是一个符号表达式求值器，能够编译自己的实现到机器代码中。整个项目的代码量大约为 2000 行左右。Maru 特别强调在最低级别上的可塑性，目的是让任何特殊需求都能在平台上得到满足，而不是被排除在外。

该项目主要使用 C 语言进行编写，同时也使用了 Lisp 语言的一些特性。

2. 项目使用的关键技术和框架

Maru 的关键技术主要包括：

• 自托管编译：Maru 能够编译自己的实现到机器代码，这意味着它可以通过自己的编译器来编译自己，形成一个闭环。
• 符号表达式求值：这是 Lisp 语言的核心特性，用于处理和计算符号表达式。
• 跨平台支持：Maru 支持多种平台，包括 Linux、MacOS 等，通过不同的后端来生成特定平台的机器码。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：Linux、MacOS 或其他支持 libc 的平台。
• 编译工具：安装 GCC 或 Clang 编译器。
• 对于 Linux 系统，可能还需要安装 gcc-multilib 以支持 32 位编译。
• 对于 MacOS 系统，确保已安装 Xcode。

安装步骤

以下是在不同操作系统上安装 Maru 的详细步骤：

在 Debian 或 Ubuntu 系统上：

1. 安装必要的编译工具和依赖：

   sudo apt update
   sudo apt install make time rlwrap
   sudo apt install llvm clang
   sudo apt install gcc-multilib  # 如果需要支持 32 位编译
   

2. 克隆项目仓库：

   git clone https://github.com/attila-lendvai/maru.git
   cd maru
   

3. 构建项目：

   make test-bootstrap-x86
   

在 MacOS 系统上：

1. 安装 Xcode 和 Homebrew（如果尚未安装）：

   xcode-select --install
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
   

2. 安装 LLVM：

   brew install llvm
   echo export PATH="$(brew --prefix llvm)/bin:$PATH" >> ~/.bash_profile
   source ~/.bash_profile
   

3. 克隆项目仓库并构建：

   git clone https://github.com/attila-lendvai/maru.git
   cd maru
   make test-bootstrap-x86
   

在其他平台上：

1. 确保您的系统支持 libc 和 GNU 工具链或 LLVM。
2. 克隆项目仓库：

   git clone https://github.com/attila-lendvai/maru.git
   cd maru
   

3. 根据平台具体情况，调整构建命令和依赖安装。

完成以上步骤后，您应该能够成功安装并运行 Maru 项目。如果遇到任何问题，请参考项目的文档或在相关社区寻求帮助。