Skip to content

README_zh.md

Latest commit

 

History

History
99 lines (68 loc) · 4.83 KB

README_zh.md

File metadata and controls

99 lines (68 loc) · 4.83 KB
Raw

RustSharp 标志

RustSharp

面向 .NET 的 Rust 兼容语言工具链。

English | 简体中文

Windows x64 P0 证据 Linux x64 Native AOT .NET SDK 10.0.400

🚧 进行中： RustSharp 仍处于实验阶段。兼容性由具名配置档定义，而不是宣称完整支持 Rust。超出配置档范围的源码会给出诊断，不会被静默赋予 C# 或 CLR 语义。

RustSharp 使用 C# 和 .NET 10 实现，目标是一个刻意限定范围的 Rust 1.98 / Edition 2024 语言实现。rsc 编译器读取 .rs 源文件及受支持的 Cargo.toml 包输入子集，生成 ECMA-335 程序集和 Portable PDB 文件；在已覆盖的配置档中，它可以在 CoreCLR 上运行，也可以通过 .NET Native AOT 发布。

当前可用范围

范围 当前支持
vertical-slice-v1 默认配置档：fn main() 加字面量 println! 语句。
safe-core-primitives-v1 可选配置档：有界文件模块和本地 path 包、非泛型函数、i32 / bool、已初始化的可变局部变量、if / else、返回、受检查算术、比较、布尔运算符和 println!。
输出 对已覆盖的配置档，直接生成 ECMA-335 和 Portable PDB，支持 CoreCLR 运行与 Native AOT 发布。

RustSharp 不是 rustc 的直接替代品。完整 Rust 兼容性、标准库对等、通用 Cargo 注册表解析、宏展开、所有权与借用检查、Rust ABI 兼容性以及任意 unsafe 代码，当前都不是承诺范围。精确边界见兼容性契约。

快速开始

请先安装 .NET SDK 10.0.400。仓库在 global.json 中固定该版本，并禁用了 roll-forward。只有运行差异一致性工作时才需要 Rust 1.98.0。

git clone https://github.com/IoTSharp/RustSharp.git
cd RustSharp
dotnet restore RustSharp.slnx
dotnet build RustSharp.slnx -c Release --no-restore
dotnet run --project src/RustSharp.Cli -c Release --no-build --no-restore -- run samples/safe-core.rs --profile safe-core-primitives-v1

该示例会输出一个由 RustSharp 编译的 i32 / bool 小程序。

CLI

已安装的 CLI 名称为 rsc。从源码检出运行时，可使用以下命令查看完整选项：

dotnet run --project src/RustSharp.Cli -c Release --no-build --no-restore -- --help

当前命令面如下：

rsc check <source.rs|Cargo.toml> [--profile <name>]
rsc build <source.rs|Cargo.toml> [--output <program.dll>] [--profile <name>]
rsc compile <source.rs|Cargo.toml> [--output <program.dll>] [--profile <name>]
rsc run <source.rs|Cargo.toml> [--output <program.dll>] [--timeout <seconds>] [--profile <name>]
rsc publish <source.rs|Cargo.toml> [--runtime <rid>] [--output <directory>] [--timeout <seconds>] [--profile <name>]

compile 保留为 build 的兼容别名。

仓库导览

路径 用途
src 编译器、语法、语义、IL 代码生成、运行时和 CLI 项目。
samples 可直接运行的小型 RustSharp 程序。
tests 有界的可执行回归测试工具。
docs 兼容性契约和架构决策。

文档

开发

完成 Release 构建后，使用以下命令运行有界可执行测试工具：

dotnet run --project tests/RustSharp.Tests/RustSharp.Tests.csproj -c Release --no-build --no-restore

本仓库当前不使用基于 Test SDK 的 dotnet test 测试套件。

参与贡献

提出语言行为变更前，请阅读对应的兼容性契约和 ADR。在同一项变更中保持实现、测试与受影响文档一致。

说明

LICENSE-UNICODE 已包含在本仓库中。其适用范围和条款以该文件的说明为准。