erg/doc/zh_CN/dev_guide/rust_code_guideline.md

Rust 代码准则

本地规则

• 用于调试的输出使用（释放时所需的输出处理也使用<gtr=“2”/>等）。
• 未使用或内部（专用和仅用于特定功能）的变量方法以一个开头。如果想避免与保留字的冲突，则在后面加上一个。

鼓励代码

• 定义并使用特定于域的 Enum，而不是数字枚举和 bool。
• 存取修饰符为必要的最小限度。即使公开时也优先使用和<gtr=“6”/>。
• for 表达式中的 iterable 对象显式转换为迭代器（，而不是<gtr=“7”/>）。
• 延迟评估。例如，当不是文字时，使用<gtr=“11”/>而不是<gtr=“10”/>。

不鼓励的代码

• 经常使用 return type overloading。具体来说，经常使用不明确的的代码。这是因为型推论结果有时违反直觉。在这种情况下，建议使用<gtr=“13”/>代替。
• 经常使用。这实质上引起了与继承相同的问题。

根据上下文判断不同的代码

• 定义未使用的 helper 方法。
• 经常使用，<gtr=“16”/>。在某些情况下，有些人别无选择，只能这样做。