Google의 Rust 스타일 가이드

무엇이 나왔나

Google은 Rust 코드를 쓰는 방법을 정리한 공식 스타일 가이드를 공개했습니다. 이 문서는 Google 안에서 Rust 코드를 일관되게 쓰기 위한 규칙을 담고 있습니다. 여기서 '스타일'은 글자 배치만 뜻하지 않고, API 설계와 구현 방식에 대한 안내도 포함합니다.

왜 이런 가이드가 필요할까

Rust는 google3, Android, ChromeOS, Fuchsia, Chrome 등 여러 곳에서 쓰입니다. Google은 이 모든 곳에서 Rust 코드가 비슷한 모습이기를 바랍니다. 코드는 오랫동안 쓰이기 때문에, 읽기 쉽게 만드는 규칙이라면 작성할 때 조금 더 애써도 가치가 있다고 봅니다. 또한 Google에서는 코드 전체를 한꺼번에 바꾸는 대규모 변경(LSC)이 자주 일어나므로, 일관된 코드가 이런 작업을 쉽게 만듭니다.

가이드의 핵심 원칙

• 공식 Rust 스타일 규칙을 우선 따릅니다. 이 가이드와 충돌할 때만 예외입니다.
• 라이브러리 코드의 API 설계 규칙은 반드시 지켜야 합니다.
• 애플리케이션 코드의 API 규칙은 강하게 권장되는 수준입니다.
• Chromium에서는 작은 크레이트를 선호하며, 가능하면 파일 하나에 한 가지 개념만 담습니다.

왜 중요한가

Google의 모든 Rust 개발자와 리뷰어가 이 규칙을 기억해야 하므로, 실제로 도움이 되는 규칙만 담으려고 합니다. 코드를 일관되게 쓰면 새로 배우는 사람도 익히기 쉽고, 대규모 자동 변경도 더 안전하고 빠르게 할 수 있습니다. 이는 큰 코드베이스를 가진 여러 회사와 프로젝트에도 참고가 될 수 있습니다.

앞으로 지켜볼 점

• 이 가이드가 Android, Chrome 등 실제 프로젝트에 어떻게 적용되는지
• 공식 Rust 스타일과 이 가이드 사이의 충돌이 어떻게 정리되는지
• 코드 리뷰에서 스타일 논쟁이 얼마나 줄어드는지