Blog

گوگل راهنمای رسمی نوشتن Rust را منتشر کرد

گوگل Style Guide رسمی Rust را منتشر کرد: از دوری از Rc و Arc و enum به جای bool تا ممنوعیت async در کروم. خلاصه‌ی قوانین مهم و نظر من درباره‌ی اینکه کدامش به درد تیم شما می‌خورد.

22 Oct 2026 · 3 min read · Rust · گوگل · Style Guide · برنامه‌نویسی · کیفیت کد · اندروید

گوگل راهنمای رسمی نوشتن Rust را منتشر کرد

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

نمودار رشد کد Rust در برابر C++ در اندروید
چرا این راهنما مهم است: در اندروید، حجم خالص کد جدید Rust حالا از C++ جلو زده (منبع: Google Security Blog، نوامبر ۲۰۲۵)

نکته‌ی مهم: اینجا «سبک» فقط فرمت کد نیست؛ فرمت را 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 مخصوص خودش.
نرخ rollback تغییرات Rust در برابر C++
داده‌ی خود گوگل: تغییرات Rust در اندروید کمتر از C++ برگردانده (rollback) می‌شوند (منبع: Google Security Blog)

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

کاهش آسیب‌پذیری‌های حافظه در اندروید
با رشد Rust، سهم آسیب‌پذیری‌های حافظه در اندروید سال به سال پایین آمده (منبع: Google Security Blog)

نظر من

به نظرم ارزش این سند فقط برای گوگلی‌ها نیست. بیشتر تیم‌هایی که Rust را تازه شروع می‌کنند، دقیقاً در همین جاها گیر می‌کنند: همه‌چیز را Arc<Mutex> می‌کنند، همه‌جا clone می‌زنند و unwrap پخش می‌کنند. یک مرجع معتبر که بگوید «نه، این‌طوری» بحث‌های بی‌پایان code review را کوتاه می‌کند. قانون enum به جای bool و expect به جای unwrap را من حتی در پروژه‌ی تک‌نفره هم رعایت می‌کنم.

ولی کورکورانه کپی‌اش نکنید. بخشی از قوانین (مثل crateهای خیلی کوچک یا ممنوعیت async در کروم) برای مونوریپوی گوگل و تغییرات خودکار عظیم آن طراحی شده، نه برای یک سرویس وب با Tokio. خود سند هم می‌گوید برای کد اپلیکیشن، قوانین API فقط توصیه‌ی قوی‌اند. پیشنهاد عملی‌ام: بخش‌های Ownership، Errors و Implementation concerns را بخوانید و بقیه را به‌عنوان پس‌زمینه ببینید. یک نکته‌ی دیگر هم هست: این سند برای دادن به ایجنت‌های کدنویسی به‌عنوان قانون پروژه هم خیلی مناسب است.

فریس، خرچنگ نماد جامعه‌ی Rust
Ferris، نماد غیررسمی جامعه‌ی Rust (منبع: rustacean.net)

منابع: Google Rust Style Guide، Google Security Blog: Rust in Android، بحث Hacker News

Comments0

Comments +

00

No comments yet — be the first. هنوز نظری ثبت نشده؛ اولین نفر باش.

Leave a comment

0 / 2000