گوگل راهنمای رسمی نوشتن Rust را منتشر کرد
گوگل Style Guide رسمی Rust را منتشر کرد: از دوری از Rc و Arc و enum به جای bool تا ممنوعیت async در کروم. خلاصهی قوانین مهم و نظر من دربارهی اینکه کدامش به درد تیم شما میخورد.
22 Oct 2026 · 3 min read · Rust · گوگل · Style Guide · برنامهنویسی · کیفیت کد · اندروید

گوگل راهنمای سبک (Style Guide) رسمی Rust خودش را منتشر کرده؛ همان سندی که مشخص میکند Rust در google3، اندروید، ChromeOS، Fuchsia و کروم چطور باید نوشته شود. این سند کنار راهنماهای معروف C++، Java و Python گوگل در سایت google.github.io/styleguide قرار گرفته و امروز با بیش از ۳۰۰ امتیاز روی صفحهی اول Hacker News بود.

نکتهی مهم: اینجا «سبک» فقط فرمت کد نیست؛ فرمت را rustfmt انجام میدهد. این سند بیشتر دربارهی طراحی API و پیادهسازی است. هدفهایش هم صریح نوشته شده: خوانایی به جای راحتیِ نوشتن، سازگاری با اکوسیستم عمومی Rust، و یک هدف کمتر دیدهشده: ساده کردن تغییرات بزرگ خودکار (LSC) که در کدبیسهای غولآسای گوگل مدام اتفاق میافتد.
چند قانون جالب
- از Rc و Arc دوری کنید: مالکیت یکتا و borrow را ترجیح دهید؛ اشارهگرهای اشتراکی فقط وقتی که جایگزینش واقعاً پیچیده است.
.clone()هم نباید جای borrow را بگیرد. - enum به جای bool: اگر معنی پارامتر bool از صدا زدن تابع معلوم نیست، یک enum تعریف کنید.
- expect به جای unwrap: اگر panic لازم است، دلیلش را در پیام بنویسید.
- بدون glob import:
use foo::*جز در چند حالت مشخص ممنوع است. - ماکرو آخرین انتخاب است: اول تابع و تایپ و trait، بعد
macro_rules!و در آخر proc_macro؛ چون IDE و Code Search روی ماکروها بد کار میکنند. - #[non_exhaustive] برای enumهای عمومی و
#[must_use]برای توابع و تایپهایی که نتیجهشان نباید دور ریخته شود. - قوانین مخصوص کروم: در Chromium نه
async/.await، نه ساختن Thread با کتابخانهی استاندارد؛ به جایش sequenceهای خود کروم. در Fuchsia هم Mutex مخصوص خودش.

بحث HN هم داغ بود. خیلیها با قانون Rc/Arc مخالف بودند و میگفتند برای دادهای که بیرون از call stack زندگی میکند، کشتی گرفتن با lifetimeها ارزشش را ندارد. عدهای هم #[non_exhaustive] روی enumها را عجیب دانستند، چون بزرگترین مزیت enum همین است که کامپایلر موارد جدید را در match به شما یادآوری کند.

نظر من
به نظرم ارزش این سند فقط برای گوگلیها نیست. بیشتر تیمهایی که Rust را تازه شروع میکنند، دقیقاً در همین جاها گیر میکنند: همهچیز را Arc<Mutex> میکنند، همهجا clone میزنند و unwrap پخش میکنند. یک مرجع معتبر که بگوید «نه، اینطوری» بحثهای بیپایان code review را کوتاه میکند. قانون enum به جای bool و expect به جای unwrap را من حتی در پروژهی تکنفره هم رعایت میکنم.
ولی کورکورانه کپیاش نکنید. بخشی از قوانین (مثل crateهای خیلی کوچک یا ممنوعیت async در کروم) برای مونوریپوی گوگل و تغییرات خودکار عظیم آن طراحی شده، نه برای یک سرویس وب با Tokio. خود سند هم میگوید برای کد اپلیکیشن، قوانین API فقط توصیهی قویاند. پیشنهاد عملیام: بخشهای Ownership، Errors و Implementation concerns را بخوانید و بقیه را بهعنوان پسزمینه ببینید. یک نکتهی دیگر هم هست: این سند برای دادن به ایجنتهای کدنویسی بهعنوان قانون پروژه هم خیلی مناسب است.

منابع: Google Rust Style Guide، Google Security Blog: Rust in Android، بحث Hacker News
Comments +
00No comments yet — be the first. هنوز نظری ثبت نشده؛ اولین نفر باش.