开源项目常见问题解决方案
项目基础介绍
本项目是全国大学生计算机系统能力大赛编译系统设计赛项目,参赛队伍来自中国科学技术大学,队伍名称为“燃烧我的编译器”。该项目实现了一个SysY语言(简化的C语言)的编译器,目标平台是树莓派(ARMv8)(32bit)。编译器具备强大的优化能力,在大多数性能测试用例上超过了GCC -O3的优化效果。
主要编程语言
项目主要使用C++编程语言,部分测试和构建工作可能涉及bash脚本。
新手常见问题及解决步骤
问题一:如何构建和运行项目?
问题描述: 新手用户可能不清楚如何从源代码构建出可执行文件,并进行测试。
解决步骤:
- 确保你的系统中已安装了CMake和GCC编译器。
- 克隆项目到本地:
git clone https://github.com/mlzeng/CSC2020-USTC-FlammingMyCompiler.git
- 进入项目根目录:
cd CSC2020-USTC-FlammingMyCompiler
- 创建构建目录并执行CMake:
mkdir build && cd build && cmake ..
- 使用4个并行任务编译项目:
make -j 4
- 编译完成后,在
build
目录下会有一个名为compiler
的可执行文件。 - 使用该可执行文件编译SysY语言源文件(例如
test.sy
):./compiler test.sy
- 使用GCC将生成的汇编文件(例如
test.s
)与SysY运行时库链接:gcc test.s libsysy.a -o test
- 运行生成的可执行文件:
./test
问题二:如何在其他平台上交叉编译项目?
问题描述: 如果用户希望在非树莓派的平台上进行交叉编译,可能会遇到编译不通过的问题。
解决步骤:
- 确保安装了适用于目标平台的交叉编译工具链,例如
arm-linux-gnueabihf-gcc
。 - 在构建目录中,设置交叉编译工具链:
CC=arm-linux-gnueabihf-gcc CXX=arm-linux-gnueabihf-g++ cmake ..
- 使用
make
命令编译项目:make
- 将编译好的汇编文件和运行时库复制到目标平台上,并使用目标平台的GCC进行链接。
问题三:如何在项目中添加新的测试用例?
问题描述: 用户可能不知道如何向项目中添加新的测试用例。
解决步骤:
- 在项目根目录下的
test
文件夹中创建一个新的SysY语言源文件,例如new_test.sy
。 - 在
test
文件夹中的run_test.sh
脚本中添加一行用于运行新测试用例的命令,例如:./compiler new_test.sy && gcc new_test.s libsysy.a -o new_test && ./new_test
- 运行
run_test.sh
脚本来执行所有测试用例,包括新添加的测试用例。
以上是新手在使用本项目时可能会遇到的三个常见问题及其详细解决步骤。希望这些信息能够帮助您更顺利地使用该项目。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考