贡献指南

社区

Volta 是一个开源项目，我们鼓励并感谢社区参与。在开始之前，我们建议您在 Discord 上与我们的团队联系，以确保您的贡献与项目的整体方向保持一致，并获得一些关于如何实现的建议。

行为准则

我们要求所有贡献者遵守我们的行为准则。请确保在参与我们的项目之前阅读并理解它。

开发

环境设置

Volta 是用 Rust 编写的。为了开始开发，您需要在您的系统上安装 Rust。我们推荐使用 rustup 来管理您的 Rust 安装。

构建

Volta 可以使用标准的 Cargo 命令进行构建：

cargo build

对于发布构建，可以使用：

cargo build --release

测试

Volta 有单元测试和集成测试。要运行所有测试，请使用：

cargo test

安装本地版本

要安装您本地构建的 Volta 版本，可以使用：

cargo install --path .

这将覆盖您当前安装的任何 Volta 版本。如果您想保留当前版本，可以在安装前备份 ~/.volta 目录。

格式化

Volta 使用 rustfmt 来保持代码风格的一致性。在提交代码之前，请确保运行：

cargo fmt

这将自动格式化您的代码以符合项目的风格指南。

提交代码

提交信息

我们要求提交信息遵循约定式提交的格式。这有助于我们自动生成变更日志并保持提交历史的整洁。

拉取请求

当您准备好提交您的代码时，请创建一个拉取请求。在拉取请求的描述中，请提供以下信息：

• 您的更改解决了什么问题
• 您如何实现解决方案
• 任何需要特别注意的事项
• 您是否已经添加了测试来验证您的更改

我们的团队将审查您的代码，并在必要时提供反馈。一旦您的代码被批准，它将被合并到主分支。

报告问题

如果您发现问题，请在 GitHub Issues 上报告。在报告问题时，请提供尽可能多的信息，包括：

• 您使用的 Volta 版本
• 您的操作系统和版本
• 问题的详细描述
• 重现问题的步骤
• 预期行为
• 实际行为
• 任何相关的错误消息或日志

这将帮助我们更快地诊断和解决问题。

文档

我们也欢迎对文档的贡献。如果您发现文档中的错误或遗漏，或者您认为可以改进文档，请随时提交拉取请求。

感谢

我们非常感谢所有为 Volta 做出贡献的人，无论贡献大小。每一个贡献都帮助使 Volta 变得更好！