Roc语言编译器从源码构建指南

Roc语言编译器从源码构建指南

roc A fast, friendly, functional language. Work in progress! 项目地址: https://gitcode.com/gh_mirrors/ro/roc

作为一门新兴的函数式编程语言，Roc正在快速发展。本文将详细介绍如何从源码构建Roc编译器，帮助开发者搭建本地开发环境。

环境准备概述

构建Roc编译器需要准备以下核心组件：

• Zig编译器（0.13.0版本）
• LLVM工具链（18.0.x版本）
• Rust工具链
• 相关系统依赖库

推荐构建方式

使用Nix环境（Linux/MacOS推荐）

Nix提供了最便捷的依赖管理方案，能自动处理所有构建依赖。

Nix安装步骤

1. 执行安装脚本（根据系统选择）：

   # WSL系统
   sh <(curl -L https://nixos.org/nix/install) --no-daemon
   
   # 常规Linux/MacOS
   sh <(curl -L https://nixos.org/nix/install) --daemon
   

2. 配置Nix特性： 在~/.config/nix/nix.conf中添加：

   experimental-features = nix-command flakes
   

3. 重启Nix服务或系统

使用Nix构建

进入项目目录后执行：

nix develop

这将进入包含所有构建依赖的shell环境。

使用开发容器

对于偏好容器化开发的用户，Roc支持通过开发容器进行构建：

1. 使用VSCode的远程容器功能
2. 或直接使用Docker环境

这种方式能确保环境隔离且一致。

手动安装方式

依赖安装指南

Zig编译器安装

必须使用0.13.0版本：

• MacOS: brew install zig
• Ubuntu: snap install zig --classic --beta
• 其他系统建议从官网下载二进制包

LLVM安装

需要18.0.x版本：

Linux (Ubuntu/Debian):

wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
./llvm.sh 18

MacOS:

brew install llvm@18
export LLVM_SYS_180_PREFIX=$(brew --prefix llvm@18)

Windows: 需要下载特殊构建的LLVM包并设置环境变量

其他依赖

• Rust工具链（通过rustup安装）
• Valgrind（测试需要）
• 系统库：libz、libzstd等

构建命令

基础构建命令：

cargo build

发布版构建：

cargo build --release --bin roc

启动REPL：

cargo run repl

性能优化建议

使用LLD链接器

显著提升构建速度：

1. 创建~/.cargo/config.toml并添加：

[build]
rustflags = ["-C", "link-arg=-fuse-ld=lld", "-C", "target-cpu=native"]

2. 安装lld-18并确保ld.lld在PATH中

WSL构建优化

在WSL中构建时，建议将项目放在Linux文件系统中，可提升20倍构建速度。

常见问题解决

1. 找不到zlib/zstd库：

sudo apt-get install libz-dev libzstd-dev

2. LLVM找不到错误：

export LLVM_SYS_180_PREFIX=/usr/lib/llvm-18

3. MacOS特殊问题：

sudo xcode-select -r
export LDFLAGS="-L/usr/local/opt/llvm/lib"

测试注意事项

运行测试套件需要valgrind，若不想安装可使用：

cargo test --no-fail-fast

通过本文的详细指导，开发者应该能够顺利搭建Roc编译器的开发环境。如果在构建过程中遇到特殊问题，建议查阅相关社区资源获取支持。

roc A fast, friendly, functional language. Work in progress! 项目地址: https://gitcode.com/gh_mirrors/ro/roc