Robyn项目本地开发环境搭建指南

Robyn是一个基于Rust和Python的高性能Web框架，本文将详细介绍如何正确搭建本地开发环境以便进行项目贡献。

环境准备

在开始之前，请确保系统已安装以下工具链：

• Rust 1.82.0或更高版本
• Python 3.12.x（3.13.0目前存在兼容性问题）
• uv工具0.4.27或更高版本
• 构建工具链（如clang）

对于Debian/Ubuntu系统，可使用以下命令安装clang：

sudo apt install clang

项目初始化

1. 首先克隆项目仓库：

git clone https://github.com/sparckles/Robyn.git
cd Robyn

2. 创建Python虚拟环境：

uv venv

3. 安装基础开发工具：

uv install pre-commit poetry maturin

依赖安装

1. 确保项目目录中包含完整的pyproject.toml和Cargo.toml文件

2. 安装开发依赖：

uv run poetry install --with dev --with test

常见问题解决

Python版本问题

目前Robyn与Python 3.13.0存在兼容性问题（主要是uvloop依赖），建议使用Python 3.12.x：

uv python pin 3.12.7

构建错误处理

如果遇到构建错误，可尝试以下步骤：

1. 确保Cargo.toml文件配置正确
2. 检查Rust工具链是否完整
3. 运行cargo build验证Rust部分能否独立编译

使用自定义构建

开发完成后，若要在其他项目中使用本地构建的Robyn版本，可通过以下方式安装：

uv add ../Robyn/target/wheels/robyn-*.whl

最佳实践

1. 建议使用pre-commit确保代码质量
2. 定期更新依赖版本
3. 在提交PR前运行完整的测试套件

通过以上步骤，开发者可以顺利搭建Robyn项目的本地开发环境，为项目贡献代码或进行自定义开发。