指导原则和基本原理

在制定风格指南时,风格团队遵循以下指导原则(大致按优先级排序)

  • 可读性

    • 可扫描性
    • 避免误导性格式
    • 可访问性 - 可被使用各种硬件的用户读取和编辑,包括非视觉辅助接口
    • 在没有语法高亮或 IDE 辅助的情况下(例如 rustc 错误消息、diff、grep 和其他纯文本环境)代码的可读性
  • 美观

    • “美”的感觉
    • 与其他语言/工具一致
  • 具体性

    • 与版本控制实践的兼容性 - 保留差异、易于合并等
    • 防止右移
    • 最小化垂直空间
  • 应用

    • 易于手动应用
    • 易于实现(在 rustfmt 以及其他工具/编辑器/代码生成器中)
    • 内部一致性
    • 格式规则的简洁性