الاختلافات بين //go:build و // build

في Go 1.17، تم تقديم توجيه تجميع شرطي جديد يسمى //go:build كبديل لـ الأقدم // توجيه البناء. في حين أن كلا التوجيهين يخدمان نفس الغرض المتمثل في تحديد قيود البناء، إلا أن هناك العديد من الاختلافات والمزايا الرئيسية لاستخدام //go:build.

اختلافات بناء الجملة:

• //go:build يتبع بناء جملة مشابهًا لتوجيهات Go الأخرى، مثل //go:generate. يأخذ تعبيرًا منطقيًا كوسيطة، والذي يحدد ما إذا كان يجب تضمين الملف في الحزمة أثناء التجميع.
• // من ناحية أخرى، يستخدم البناء بناء جملة أقل سهولة. يقبل قائمة علامات مفصولة بفواصل لتحديد الأنظمة الأساسية أو الشروط التي يجب تضمين الملف من أجلها.

تفاصيل التنفيذ:

• في إصدارات Go 1.17 والإصدارات الأحدث، //go:build هو التوجيه المفضل وستتم إزالته بشكل فعال بواسطة سلسلة الأدوات، كما هو مذكور في ملاحظات إصدار Go 1.18.
• // سوف البناء يستمر دعمه لعدد قليل من إصدارات Go لضمان الانتقال السلس، ولكن لا يُنصح باستخدامه في الإصدارات الأحدث.

مزايا //go:build:

• الاتساق: //go:build يتماشى مع توجيهات Go وبراغماتها الأخرى، مما يجعلها متسقة وأسهل تذكر.
• بناء الجملة المحسن: //go:build يقدم بناء جملة تعبير منطقي أكثر قياسية، باستخدام & و || لشروط AND وOR، على التوالي. وهذا على النقيض من // build، الذي يستخدم الفواصل لـ AND والمسافات لـ OR.
• دعم Go fmt: //go:build مدعوم بواسطة go fmt، والذي يعمل تلقائيًا على إصلاح الأخطاء وضع التوجيه في الملفات المصدر. يساعد هذا في تجنب الأخطاء الشائعة، مثل عدم ترك سطر فارغ بين التوجيه وبيان الحزمة.
• رسائل الخطأ التفصيلية: //go:build يوفر رسائل خطأ أكثر تفصيلاً أثناء التجميع، المساعدة في تحديد أي مشكلات تتعلق بقيود البناء.

الاستخدام:

بينما يتم استخدام كلا التوجيهين لتحديد قيود البناء، يُفضل //go:build بشكل عام نظرًا لمزاياه. فيما يلي مثال يوضح استخدام كلا التوجيهين:

//go:build linux && amd64 الحزمة الرئيسية // بناء لينكس، AMD64 package main

//go:build linux && amd64
package main

//  build linux,amd64
package main

في هذا المثال، سيحقق كلا التوجيهين نفس النتيجة، وهي تضمين الحزمة الرئيسية فقط عند التجميع لنظام Linux وهندسة AMD 64 بت.

الخلاصة:

//go:build يوفر العديد من المزايا مقارنة بـ // build، بما في ذلك بناء الجملة المتسق ورسائل الخطأ المحسنة ودعم go fmt. إنه التوجيه المفضل لتحديد قيود البناء في Go 1.17 والإصدارات الأحدث.