تحديد مزالق حالة الأنبوب وset -e

افهم الأسباب المحتملة

• تعكس النتيجة الأخير لا كل المطلوب. تغير pipefail التجميع لا معنى الفشل. لـ errexit وERR استثناءات قواعد واستدعاء، وقد يستبدل التسجيل أو local الحالة المطلوبة.

1. الإعادة بآمن في البنية نفسها

سجل العادي والشرط والنفي والقائمة والأنبوب والخيارات والإصدار. استبدل النشر أو الإدارة بمنتج مصطنع وحالات. افحص الجسم والمستدعي ولا تضف خيارات قبل مصدر الصفر. افصل التشخيص عن الجزئي كي لا تجمله.

bash -e -c 'work() { false; printf "continued-inside-function\n"; }; if work; then printf "condition-succeeded\n"; fi'

continued-inside-function
condition-succeeded

2. حفظ كل مراحل الأنبوب قبل التسجيل

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

set +e
{ printf 'partial\n'; return_status=6; ( exit "$return_status" ); } | { while IFS= read -r line; do :; done; }
stages=("${PIPESTATUS[@]}")
printf 'producer=%s consumer=%s\n' "${stages[0]}" "${stages[1]}"

producer=6 consumer=0

3. معالجة العمليات المطلوبة صراحة

استخدم if حول مؤثر الصحة واحفظ الحالة أول else. لا تعتمد الدالة خيار المستدعي وأعد غير صفري موثقاً ولا تدعه للتشخيص. افصل local عن الاستبدال الحساس. تفيد pipefail مع تحديد الغياب والاختياري والتحقق؛ لا يقرر المفتاح المتطلبات.

4. إبعاد الجزئي عن حد الإكمال

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

امنع تكرار المشكلة

• وثق المطلوب والاختياري واحفظ ملاصقاً وأعد الفشل بالدوال. احفظ اختبارات دالة الشرط والمنتج الجزئي ووثق الدعم لا خيارات كاستثناء شامل.