fast-rust

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

fast-rust

fast-rust

Concise guidance for high-quality Rust engineering, balancing correctness, maintainability, and performance.
高质量Rust工程的简明指南,兼顾正确性、可维护性与性能。

Purpose and Triggers

目的与适用场景

  • Writing new code, refactoring, reviewing, or designing public APIs/CLIs.
  • Rust or files with
    .rs
    .
  • Prefer clear boundaries, error semantics, and evolvability.
  • 编写新代码、重构、评审或设计公共API/CLI。
  • 适用于Rust或.rs后缀的文件。
  • 优先考虑清晰的边界、错误语义和可演进性。

Decision Order

决策优先级

  1. Correctness and clear boundaries
  2. Readability and maintainability
  3. Extensibility and evolution cost
  4. Performance and optimization
  1. 正确性与清晰边界
  2. 可读性与可维护性
  3. 可扩展性与演进成本
  4. 性能与优化

Workflow

工作流程

  1. Locate the relevant topic below.
  2. Apply the guidance and examples.
  3. Read the reference if you need more detail.
  1. 找到下方相关主题。
  2. 应用指南与示例。
  3. 如需更多细节,请阅读参考资料。

Topics

主题

TopicGuidanceReference
Error DesignDesign error boundaries and semantics before propagationreferences/error-design.md
CompilationOptimize build time and release performance with measured changesreferences/compilation-optimization.md
Type ExerciseType-level exercise for expression engines and dispatchreferences/type-exercise.md
主题指南参考资料
错误设计在错误传播前设计错误边界和语义references/error-design.md
编译优化通过可量化的变更优化构建时间和发布性能references/compilation-optimization.md
类型实践表达式引擎与调度的类型层面实践references/type-exercise.md

References

参考资料

  • Each topic file lists source URLs in frontmatter
    urls
    .
  • 每个主题文件在前置元数据
    urls
    中列出了来源URL。