指导原则和基本原理
在制定风格指南时,风格团队遵循以下指导原则(大致按优先级排序)
-
可读性
- 可扫描性
- 避免误导性格式
- 可访问性 - 可被使用各种硬件的用户读取和编辑,包括非视觉辅助接口
- 在没有语法高亮或 IDE 辅助的情况下(例如 rustc 错误消息、diff、grep 和其他纯文本环境)代码的可读性
-
美观
- “美”的感觉
- 与其他语言/工具一致
-
具体性
- 与版本控制实践的兼容性 - 保留差异、易于合并等
- 防止右移
- 最小化垂直空间
-
应用
- 易于手动应用
- 易于实现(在
rustfmt
以及其他工具/编辑器/代码生成器中) - 内部一致性
- 格式规则的简洁性