Uber هي شركة تكنولوجيا مقرها سيليكون فالي، الولايات المتحدة الأمريكية، وهي معتمدة مبكرًا على لغة Go. لقد قامت بنشر العديد من مشاريع الـ golang مفتوحة المصدر، مثل zap وjaeger المعروفة في مجتمع Gopher. في نهاية عام 2018، قامت Uber بنشر دليل أسلوب Go الداخلي على GitHub. بعد عام من التراكم والتحديثات، اتخذ الدليل شكله وحظي بانتباه واسع من قبل Gophers. هذه المادة هي النسخة الصينية من الدليل.
أسلوب الكود يحكم التقاليد التي تسيطر على كودنا. تغطي هذه التقاليد ليس فقط تنسيق ملف المصدر الذي يتعامل معه gofmt بالنسبة لنا.
غرض هذا الدليل هو إدارة هذه التعقيد من خلال وصف الاعتبارات بالتفصيل لكتابة كود Go في Uber. وجود هذه القواعد هو جعل قاعدة الشيفرة سهلة الإدارة مع السماح للمهندسين باستخدام ميزات لغة Go بشكل أكثر فعالية.
كان الدليل مكتوبًا أولاً من قبل Prashant Varanasi و Simon Newton بهدف تمكين الزملاء من استخدام Go بسرعة. على مر السنين، تم تعديل الدليل بناءً على ملاحظات الآخرين.
يسجل هذا المستند التقاليد الدالة في كود Go التي نتبعها في Uber. العديد من هذه التوجيهات هي إرشادات عامة لـ Go، بينما تعتمد التوجيهات الموسعة الأخرى على الأدلة الخارجية التالية:
هدفنا هو جعل أمثلة الشيفرة مناسبة للاستخدام مع إصداري Go المستقرين releases.
يجب على كل الشيفرة أن تمر بفحوصات golint
و go vet
دون أخطاء. نوصي بضبط محرر النصوص الخاص بك للقيام بما يلي:
- تشغيل
goimports
عند الحفظ - تشغيل
golint
وgo vet
لفحص الأخطاء
مستودع GitHub: https://github.com/uber-go/guide
مستودع GitHub: https://github.com/xxjwxc/uber_go_guide_cn