شرح قالب .gitignore لـ Rust

Rust.gitignore قالب قصير لا يضم إلا الحد الأدنى من القواعد اللازمة لمشاريع Cargo. عدد قواعده قليل لأن معظم المخرجات تتجمع في مجلد واحد هو target/.

كان القالب القديم يرشد إلى تجاهل Cargo.lock في حالة المكتبات، لكن القالب الحالي لا يتضمن هذه القاعدة. غيّر فريق Rust توصيته عام 2023 فصار إيداع Cargo.lock هو الافتراضي في كل المشاريع بما فيها المكتبات.

شرح القواعد

النمط	ما الذي يتجاهله ولماذا
targetdebug	نتائج بناء Cargoالمجلد الذي يضع فيه cargo build نتائج الترجمة وذاكرة البناء التزايدي ومخرجات بناء الاعتماديات. قد يبلغ حجمه عدة غيغابايت، ويُعاد إنشاؤه بالكامل. ولأنه لا ينتهي بـ / فإن الملف الذي يحمل الاسم نفسه يُتجاهَل أيضًا.
**/*.rs.bk	نسخ rustfmt الاحتياطيةنسخ احتياطية يتركها rustfmt قبل تعديل الملفات. يبدأ النمط بـ **/ فيطابق على أي عمق.
*.pdb	معلومات تصحيح MSVCقاعدة بيانات رموز التصحيح التي تنشأ عند البناء بسلسلة أدوات MSVC على Windows.
**/mutants.out*/	نتائج اختبار الطفراتمجلدات النتائج التي ينشئها cargo-mutants (mutants.out وmutants.out.old). بسبب / في النهاية يطابق النمط المجلدات فقط.
rustc-ice-*.txt	تفريغ أخطاء المترجم الداخليةتتبع المكدس الذي يتركه rustc في المجلد الحالي عند مواجهة خطأ داخلي في المترجم (ICE). يفيد في الإبلاغ عن الأخطاء، لكن لا حاجة إليه في المستودع.

ملاحظات عملية

• أودِع Cargo.lock. التوصية الافتراضية الحالية في Cargo أن تودعه المكتبات أيضًا لضمان بناء قابل لإعادة الإنتاج واتساق نتائج CI.
• عند استخدام مساحة عمل (workspace) ينشأ target/ واحد فقط في جذرها، لكن لأن قاعدة target بلا شرطة مائلة فإنه يُتجاهَل أينما نشأ.
• تُعالج إعدادات RustRover وIntelliJ عبر قالب JetBrains على حدة. وتذكر تعليقات القالب أيضًا أن تجاهل .idea/ بالكامل غير مستحسن.

القالب الأصلي

# Generated by Cargo# will have compiled files and executablesdebugtarget# These are backup files generated by rustfmt**/*.rs.bk# MSVC Windows builds of rustc generate these, which store debugging information*.pdb# Generated by cargo mutants# Contains mutation testing data**/mutants.out*/# rustc will dump stack traces when hitting an internal compiler error to PWDrustc-ice-*.txt# RustRover#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore#  and can be added to the global gitignore or merged into this file.  For a more nuclear#  option (not recommended) you can uncomment the following to ignore the entire idea folder.#.idea/

قوالب تُستخدم معه

شروح قوالب أخرى