باگ و دیباگ؛ گزارشِ مشکلِ فنی به آلمانی
گزارشِ باگِ آلمانیِ خوب چهار چیز دارد: چه انتظاری داشتی (Erwartet)، چه شد (Tatsächlich)، چطور بازتولید می‌شود (Reproduktion) و محیط (Umgebung). جملهٔ طلایی: „Ich kann den Fehler reproduzieren“ (می‌توانم خطا را بازتولید کنم) — و برای ناشناخته‌ها: „Ich bin noch nicht dahintergekommen“ (هنوز ریشش را پیدا نکردم).
باگ، همیشه هست و همیشه هم باید گزارشش بدهی — به تیم، به DevOps، به مشتری! زبانِ باگ در آلمانی، زبانِ دقت است: «کار نمی‌کند» را آلمانیِ مهندسی، تجزیه میکند: کجا، کِی، با چه ورودی، چه پیامی!
این درس هم گزارشِ باگ را می‌سازد (قالبِ چهارپارچه که تیمت عاشقش می‌شود!) هم واژگانِ دیباگِ زنده را: reproduzieren، eingrenzen، Ursache، Workaround — چهار کلمه‌ای که نیمی از هر گفتگوی فنیِ روزمرهٔ تو را می‌سازند!
قالبِ گزارشِ باگ؛ چهارپارچهٔ مهندسی
| پارچه | سوال | جملهٔ نمونه |
|---|---|---|
| Erwartet (منتظره) | چه باید می‌شد؟ | „Erwartet: Der Login leitet zum Dashboard.“ |
| Tatsächlich (واقعی) | چه شد؟ | „Tatsächlich: Es kommt ein 500er.“ |
| Reproduktion (بازتولید) | چطور دوباره بشود؟ | „Schritte: 1) … 2) … — passiert immer.“ |
| Umgebung (محیط) | کجا/چه نسخه؟ | „Staging, Version 2.4.1, Chrome.“ |
این چهارپارچه، استانداردِ جهانیِ باگ-ریپورت است — اما جمله‌های آلمانی‌اش را همین‌جا قفل کن: „Der Fehler tritt nur in Staging auf“ (خطا فقط در استیجینگ رخ می‌دهد)، „Ich kann ihn nicht immer reproduzieren“ (همیشه نمی‌توانمش بازتولید کنم — سخت‌ترین نوعِ باگ!)
واژگانِ دیباگ؛ هشت کلمهٔ روزانه
| واژه | معنی | جمله |
|---|---|---|
| der Fehler | خطا | Ich habe einen Fehler gefunden. |
| reproduzieren | بازتولیدکردن | Ich kann den Fehler reproduzieren. |
| eingrenzen | محدودکردن (ریشه‌یابی) | Ich habe den Fehler eingegrenzt: Es liegt am Parser. |
| die Ursache | علتِ ریشه‌ای | Die Ursache ist ein Null-Pointer. |
| der Workaround | راه‌حلِ موقت | Als Workaround können wir den Cache leeren. |
| der Stacktrace / Log | استک‌تریس/لاگ | Schick mir bitte den Stacktrace. |
| nachvollziehen | پی‌گیری/فهمیدن | Ich kann das Verhalten nachvollziehen. |
| fixen / der Fix | فیکس‌کردن | Der Fix ist im Review. |
گفتگو: جفت‌دیباگ — دو نفر، یک باگ
گرامرِ عمیق‌تر: فعل‌های جدانشدنیِ فنی — fehlschlagen، auffallen، zusammenbrechen
زبانِ باگ، پر از فعل‌های جدانشدنی است و پیشوندشان به آخرِ جمله می‌رود: fehlschlagen (شکست‌خوردن: „Der Login schlägt fehl“)، auffallen (به‌چشم‌آمدن: „Mir ist etwas aufgefallen“ نکته‌ای به چشمم آمد!)، zusammenbrechen (فروپاشیدن: „Der Service bricht zusammen“)، abschmieren (خراب‌شدنِ محاوره‌ای: „Der Server schmiert ab!“). چهار فعل + قاعدهٔ جایگاه = گفتگوی دیباگِ کامل!
اشتباه‌های رایجِ فارسی‌زبان‌ها در همین درس
این بخش را با یک قرارداد بخوان: هر ❌ یعنی «مغزِ فارسی‌زبانت این را می‌سازد و طبیعی است»، و هر ✅ یعنی «این همان چیزی است که گیرندهٔ آلمانی‌زبان می‌شنود». با هر جفت بلند تکرار کن تا شکلِ درست در گوشت نشست کند.
تمرین‌های این درس — چهار قدم، بی‌عجله
تمرین: یک باگِ واقعی/خیالی را کامل گزارش کن:
- چهارپارچهٔ باگ را برای یک مشکلِ واقعیِ فنی‌ات (یا خیالی!) بنویس.
- سه جملهٔ دیباگ با واژگانِ درس بساز: reproduzieren، eingrenzen، Workaround.
- دیالوگِ جفت‌دیباگ را اجرا کن — هر دو نقش، با لحظهٔ «Moment!»!
- سه فعلِ جدانشدنیِ فنی را در جمله‌های واقعی بگو: fehl schlagen، auffallen، abschmieren.
پاسخ تمرین‌ها — اول خودت جواب بده، بعد باز کن
پاسخ تمرین ۱
پاسخ تمرین ۲
پاسخ تمرین ۳
پاسخ تمرین ۴
چالشِ امروز
🎯 امروز یک باگ — واقعی یا خیالی — را با قالبِ چهارپارچه به آلمانی بنویس و در چت/برگه تمرین کن. مهندسیِ آلمانی با گزارشِ دقیق شروع می‌شود، نه با فیکسِ سریع!
نکات مکالمهٔ واقعی که کتاب‌ها کم میگویند
- «Welche Schritte führen zum Fehler?» اولین سوالِ هر دیباگرِ آلمانی است — مراحلِ بازتولید! اگر از قبل نوشته باشی (۱، ۲، ۳…)، نیمی از دیباگ تمام است. جملهٔ پیشگیرانه: „Ich habe die Schritte ins Ticket geschrieben“ (مراحل را در تیکت نوشته‌ام.)
- مرزِ «فیکسِ سریع» و «فیکسِ درست» را در جمله بگو — „Quick and dirty würde gehen, aber sauber dauert einen Tag“ (سریع-و-کثیف ممکن است، ولی تمیز یک روز می‌برد) — خودِ این شفافیت، در فرهنگِ آلمانیِ مهندسی، امضای حرفه‌ای بودن است!
- پنجاه‌درصدِ باگ‌هایِ «عجیب»، محیط/داده‌اند نه کد — Umlaut در اسم، تایم‌زون، کشِ قدیمی، یکشنبه‌ها! قبل از کد، این سه را در گزارشت رد کن: „Cache geleert, anderer Browser, Zeitzone geprüft — Fehler bleibt.“ (کش خالی شد، مرورگر دیگر، تایم‌زون چک شد — خطا ماند.) — سه‌جمله‌ای که دیباگرِ بعدی را نیم‌روز جلو می‌اندازد!
گزارشِ باگِ آلمانی = چهارپارچه: Erwartet، Tatsächlich، Reproduktion، Umgebung. واژگانِ کلیدی: reproduzieren، eingrenzen، Ursache، Workaround. فعل‌های جدانشدنی: fehl schlagen (شکست می‌خورد)، auffallen، abschmieren — پیشوند آخر! و «Ich habe die Schritte ins Ticket geschrieben» = احترامِ مهندسی.