اوبر یک شرکت فناوری با مقر اصلی در وادی سیلیکون ، آمریکا است و اولین افرادی بودند که زبان Go را به کار گرفتند. آن‌ها بسیاری از پروژه‌های golang را منبع باز کرده‌اند، از جمله پروژه‌های معروف zap و jaeger در انجمن Gopher. در پایان سال 2018 ، اوبر راهنمای سبک داخلی خود را در GitHub منبع باز کرد. پس از یک سال انباشت و به‌روزرسانی، راهنما شکل گرفت و توجه گسترده‌ای از سوی Gopher‌ها دریافت کرد. این مقاله نسخه چینی این راهنما است.

استایل کد بر اصولی است که کنترل‌های ما بر روی کد را تعیین می‌کند. این اصول نه تنها فرمت فایل منبع را پوشش می‌دهند که توسط gofmt برای ما پردازش می‌شود.

هدف این راهنما مدیریت این پیچیدگی است توسط توصیف جزئیات در نظر گرفتن دقیق ملاحظات نوشتن کد Go در اوبر. وجود این قوانین برای این است که کدها راحت قابل مدیریت باشند اما همچنان به مهندسان اجازه استفاده بهتر از ویژگی‌های زبان Go را بدهد.

این راهنما ابتدا توسط Prashant Varanasi و Simon Newton نوشته شده و هدف آن این بود که همکاران را قادر به سریع استفاده از Go کند. در طی سال‌ها، راهنما بر اساس بازخوردهای دیگران تغییر یافته است.

این سند کنونی ویژگی‌های عادی در کد Go را که در اوبر دنبال می‌کنیم، ثبت می‌کند. بسیاری از این‌ها راهنمایی‌های عمومی برای Go هستند و حالت‌های گسترده‌تر دیگر به رهنمودهای خارجی زیر وابسته‌اند:

  1. Effective Go
  2. Go Common Mistakes
  3. Go Code Review Comments

هدف ما این است که نمونه‌های کد را برای استفاده با دو نسخه Go انتشارات مناسب کنیم.

همه کد باید بدون خطا از چک‌های golint و go vet عبور کنند. ما پیشنهاد می‌دهیم که ویرایشگر خود را به شرح زیر تنظیم کنید:

  • هنگام ذخیره کردن، goimports را اجرا کنید
  • برای بررسی خطاها، golint و go vet را اجرا کنید

مخزن GitHub: https://github.com/uber-go/guide

مخزن GitHub: https://github.com/xxjwxc/uber_go_guide_cn