Lorixen.
AR

أسماء الملفات العربية تظهر أرقاماً غريبة في git: core.quotePath

باختصار: إذا كان فريقك يحفظ ملفات بأسماء عربية في مستودع git، مثل «عرض-سعر-شركة-النور.pdf» أو صور منتجات مسماة بالعربية، ثم ظهرت هذه الأسماء في الطرفية أو في سجل النشر كسلسلة من الأرقام والشرطات المائلة داخل علامات تنصيص، فالملفات سليمة. توثيق git يشرح أن الأوامر التي تعرض مسارات الملفات تعتبر البايتات الأكبر من 0x80 أحرفاً «غير اعتيادية»، فتضع الاسم بين علامتي تنصيص وتكتب هذه البايتات بترميز ثماني. والإعداد core.quotePath قيمته الافتراضية true. إذا ضبطته على false، تظهر الأسماء العربية كما هي.

كيف يبدو الأمر؟

مكتب تصميم داخلي في عمّان يحفظ ملفات المشاريع في مستودع git: المخططات، وعروض الأسعار، وصور المواد. المصممون يسمون الملفات بالعربية لأنهم يبحثون عنها بالعربية. لكن عندما فتح المطور الذي يدير المستودع قائمة التغييرات في الطرفية، رأى أسطراً مثل اسم ملف يبدأ بعلامة تنصيص، ثم سلسلة طويلة من الشرطة المائلة والأرقام، ثم امتداد pdf.

ظن المطور أن الأسماء تلفت، وكاد يعيد تسمية كل الملفات بالإنجليزية. وفي أداة النشر الآلي ظهرت الأسماء بالشكل نفسه في السجلات. هذا مثال توضيحي لحالة شائعة مع الأسماء العربية، ويتكرر مع أي أسماء بأحرف غير لاتينية.

ماذا يفعل git بالضبط؟

توثيق git-config يشرح الإعداد core.quotePath: الأوامر التي تعرض المسارات، مثل عرض الملفات وعرض الفروق، تضع الأحرف «غير الاعتيادية» في اسم الملف بين علامتي تنصيص، وتهرّبها بالشرطة المائلة بطريقة لغة C نفسها في الأحرف الخاصة، أو تهرّب البايتات التي قيمتها أكبر من 0x80، مثلاً بالترميز الثماني.

كل حرف عربي في ترميز UTF-8 يتكون من أكثر من بايت، وكل هذه البايتات قيمتها أكبر من 0x80. لذلك يتحول كل حرف عربي في العرض إلى عدة مجموعات من الأرقام الثمانية. اسم من خمسة أحرف عربية يصبح سلسلة طويلة.

المهم: هذا عرض فقط. الاسم المخزن في المستودع ما زال الاسم العربي نفسه، والملف نفسه سليم.

الحل: core.quotePath = false

التوثيق يذكر أنه إذا ضُبط هذا الإعداد على false، لا تعود البايتات الأعلى من 0x80 تعتبر غير اعتيادية. ويذكر أن القيمة الافتراضية true.

يمكن ضبطه على مستوى المستخدم ليشمل كل المستودعات على جهاز المطور، أو على مستوى مستودع واحد. بعد الضبط، تظهر الأسماء العربية كما هي في قائمة التغييرات والفروق.

لاحظ ما يقوله التوثيق أيضاً: علامات التنصيص المزدوجة، والشرطة المائلة العكسية، وأحرف التحكم، تُهرّب دائماً بغض النظر عن هذا الإعداد. والمسافة العادية لا تُعتبر غير اعتيادية. لذلك اسم الملف الذي يحتوي مسافات لن يُحاط بعلامات تنصيص لهذا السبب وحده.

الطرفية يجب أن تدعم UTF-8 أيضاً

ضبط git وحده لا يكفي إذا كانت الطرفية نفسها لا تعرض UTF-8. بعد إطفاء التهريب، قد تظهر الأسماء العربية كمربعات أو أحرف غريبة إذا كان الخط أو إعداد الطرفية لا يدعمها. هذه مشكلة مختلفة في برنامج الطرفية، لا في git. وعرض العربية من اليمين إلى اليسار داخل الطرفيات متفاوت، فقد تظهر الأحرف صحيحة بترتيب يصعب قراءته.

السكربتات التي تقرأ أسماء الملفات

إذا كان لديكم سكربت نشر يقرأ قائمة الملفات المتغيرة من git ثم يرفعها إلى الخادم أو يعالج الصور، فالتهريب قد يسبب مشكلة حقيقية لا شكلية: السكربت يقرأ الاسم المهرّب ويبحث عن ملف بهذا الاسم الغريب فلا يجده.

التوثيق يذكر حلاً مخصصاً لهذا: كثير من الأوامر تستطيع إخراج أسماء المسارات حرفياً بالكامل باستخدام الخيار -z. هذا الخيار يفصل الأسماء بحرف فارغ بدل سطر جديد، ويخرجها دون تهريب، وهو الأسلم للسكربتات لأنه يتعامل أيضاً مع الأسماء التي تحتوي أحرفاً خاصة.

القاعدة: للعرض على الشاشة، اضبط core.quotePath. للسكربتات، استخدم -z.

إذا كان أحد المصممين يستخدم Mac

هناك مسألة أخرى قريبة يذكرها التوثيق: الإعداد core.precomposeUnicode، ويقول إنه يُستخدم فقط في نسخة git على نظام Mac، وإنه عند ضبطه على true يعكس git تفكيك أحرف يونيكود في أسماء الملفات الذي يقوم به Mac، وإن ذلك مفيد عند مشاركة مستودع بين Mac ولينكس أو ويندوز.

هذه المشكلة أشهر مع الأحرف اللاتينية ذات العلامات، لكن إذا لاحظت أن ملفاً بالاسم نفسه يظهر مرتين، أو أن ملفاً أضافه مصمم من Mac لا يتعرف عليه زميله على ويندوز كالملف نفسه، فهذا الإعداد يستحق المراجعة مع المطور.

ماذا عن رسائل الحفظ بالعربية؟

أسماء الملفات شيء، ورسائل الحفظ التي يكتبها الفريق عند كل تعديل شيء آخر. بعض الفرق تكتب هذه الرسائل بالعربية، مثل «تحديث عرض سعر شركة النور». توثيق git-config يذكر إعداد i18n.commitEncoding، ويقول إنه ترميز الأحرف الذي تُخزن به رسائل الحفظ، وإن git نفسه لا يهتم به بحد ذاته، لكن المعلومة ضرورية مثلاً عند استيراد الحفظ من البريد أو في متصفح السجل الرسومي، وإن القيمة الافتراضية utf-8. ويذكر إعداد i18n.logOutputEncoding الذي يحدد الترميز الذي تُحوّل إليه الرسائل عند عرض السجل.

في أغلب الحالات، ما دام الجميع يعملون بـ UTF-8، لا تحتاج تغيير شيء. لكن إذا ظهرت رسائل الحفظ العربية مشوهة عند أحد أعضاء الفريق، خصوصاً على جهاز ويندوز قديم، فهذان الإعدادان وإعداد الطرفية هي أول ما يُراجع.

هل الأفضل تجنب الأسماء العربية؟

ليس بالضرورة. الأسماء العربية تساعد الفريق على إيجاد الملفات. لكن هناك اعتبارات عملية:

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

قائمة إعداد سريعة للمطور

  1. اضبط core.quotePath على false في إعدادات المستخدم على جهازه وعلى خادم النشر.
  2. تأكد أن الطرفية تستخدم ترميز UTF-8 وخطاً يدعم العربية.
  3. في سكربتات النشر، استخدم -z عند قراءة أسماء الملفات من git.
  4. إذا كان في الفريق من يستخدم Mac، راجع إعداد precomposeUnicode.
  5. جرّب بإضافة ملف تجريبي باسم عربي، وتأكد أنه يظهر صحيحاً ويُنشر صحيحاً.

أسئلة شائعة

ليش أسماء الملفات العربية بتطلع أرقام غريبة في git؟

لأن git يعتبر بايتات الأحرف العربية «غير اعتيادية» افتراضياً، فيعرضها بترميز ثماني بين علامتي تنصيص. الملفات نفسها سليمة.

كيف أخلي git يعرض الأسماء بالعربي؟

اضبط core.quotePath على false. التوثيق يقول إن البايتات الأعلى من 0x80 لا تعود تعتبر غير اعتيادية.

سكربت النشر ما بلاقي الملفات العربية، ليش؟

لأنه يقرأ الأسماء المهرّبة. استخدم الخيار -z لإخراج الأسماء حرفياً.

هل لازم أغير أسماء الملفات للإنجليزي؟

ليس بالضرورة. المشكلة في العرض، ويمكن ضبطها. لكن فكّر في الإنجليزية للملفات التي ستُنشر كروابط.

إذا كانت ملفات فريقك بأسماء عربية تسبب مشاكل في النشر أو الأدوات، تواصل معنا ونضبطها معك.

المصادر

WhatsAppاحجز مكالمة