Lisp Koans 开源项目常见问题解决方案

Lisp Koans 开源项目常见问题解决方案

lisp-koans Common Lisp Koans is a language learning exercise in the same vein as the ruby koans, python koans and others. It is a port of the prior koans with some modifications to highlight lisp-specific features. Structured as ordered groups of broken unit tests, the project guides the learner progressively through many Common Lisp language features. 项目地址: https://gitcode.com/gh_mirrors/li/lisp-koans

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

Lisp Koans 是一个开源语言学习练习项目，旨在帮助初学者通过一系列有序的单元测试来逐步掌握 Common Lisp 编程语言。这个项目是基于 Ruby Koans 和 Python Koans 等类似项目改编的，专门突出了 Lisp 语言的特点。项目通过修复断言测试中的错误，引导学习者逐步了解 Common Lisp 的各种特性。

主要编程语言：Common Lisp

2. 新手在使用这个项目时需要特别注意的3个问题和详细解决步骤

问题一：如何开始运行 Lisp Koans 项目？

解决步骤：

1. 确保你的系统中已安装了 Common Lisp 解释器。可以选择 SBCL、CCL、CLISP 等解释器。
2. 从终端执行 Lisp 解释器，并加载 contemplate.lisp 文件。以下是一些常见 Lisp 解释器的加载命令示例：

   sbcl --script contemplate.lisp
   ccl -n -l contemplate.lisp
   clisp -q -norc -ansi contemplate.lisp
   

3. 执行完加载命令后，使用 --eval '(quit)' 命令退出解释器。

问题二：如何自动监测和运行 Koans 文件？

解决步骤：

1. 在 Linux 系统上，可以使用 meditate-linux.sh 脚本来自动监测和运行 Koans 文件。在 MacOS 系统上，需要安装 fswatch，然后使用 meditate-macos.sh 脚本。
2. 在项目根目录下打开终端，运行相应的脚本：

   sh meditate-linux.sh  # 在 Linux 系统上
   sh meditate-macos.sh  # 在 MacOS 系统上
   

3. 脚本运行后，会自动监测 Koans 文件的变化，并在修改后立即运行测试。

问题三：如何理解测试输出和定位问题？

解决步骤：

1. 运行测试后，如果输出包含 "INCOMPLETE" 字样，表示当前的 Koans 文件中有断言测试未通过。
2. 查找输出中提到的文件和断言测试的行号，定位到对应的 assert-equal 或其他断言测试。
3. 根据断言失败的提示信息，修正代码中的错误。通常，你需要填写或修改 fill-in-the-blanks 部分的代码，直到所有断言测试通过。

通过以上步骤，新手可以更好地开始学习和使用 Lisp Koans 项目，逐步掌握 Common Lisp 编程语言。

lisp-koans Common Lisp Koans is a language learning exercise in the same vein as the ruby koans, python koans and others. It is a port of the prior koans with some modifications to highlight lisp-specific features. Structured as ordered groups of broken unit tests, the project guides the learner progressively through many Common Lisp language features. 项目地址: https://gitcode.com/gh_mirrors/li/lisp-koans