کدنماAI-Coding.irتازه‌های هوش مصنوعی و کدنویسی
دلار (تتر) ۲۷۰٬۳۵۴ تومانAMD ۵۲۴٫۱۳ ▲ +۴٫۱٪AVGO ۳۵۵٫۳۴ ▲ +۴٫۰٪AMZN ۲۶۶٫۹۶ ▲ +۳٫۵٪NVDA ۱۵۰٫۹۶ ▼ −۲٫۹٪BABA ۸۵٫۱۱ ▼ −۱٫۸٪SPCX ۱۴۳٫۹۹ ▲ +۱٫۶٪پرکاربردترین مدل برنامه‌نویسی DeepSeek V4.1 Flash 1017

آموزش / کار حرفه‌ای و تیمی / درس ۱۰ از ۱۵

اشکال‌زدایی با هوش مصنوعی

چه اطلاعاتی به مدل بدهید، چطور به‌جای «درستش کن» فرضیه و آزمایش بخواهید، و سه دامی که باگ را پنهان می‌کند نه درست.

متوسط، ۷ دقیقه مطالعه

در این آموزش
  1. چه چیزهایی بدهید
  2. الگوی کار
  3. ایجنت‌ها خودشان آزمایش می‌کنند
  4. سه دامی که باید مراقبشان باشید
  5. بعد از حل مشکل

هوش مصنوعی در اشکال‌زدایی بسیار کمک می‌کند، به شرطی که آن را مثل یک کارآگاه به کار ببرید، نه یک تعمیرکار عجول. بدترین درخواست این است: «این خطا را درست کن». بهترینش این است: «علت‌های محتمل را بگو و راه آزمودن هر کدام را».

چه چیزهایی بدهید

  1. پیام خطای کامل و stack trace؛ نه خلاصه‌ی خودتان.
  2. کد مرتبط: تابعی که خطا می‌دهد و هر جا که داده‌اش را می‌سازد.
  3. نسخه‌ها: زبان، فریم‌ورک، کتابخانه‌ی مشکوک.
  4. رفتار مورد انتظار و رفتار واقعی.
  5. آنچه امتحان کرده‌اید تا مدل همان مسیر را پیشنهاد ندهد.
  6. راه بازتولید: ورودی یا گام‌هایی که خطا را می‌سازند.

الگوی کار

  1. بازتولید: اول خطا را قابل‌تکرار کنید. بهترین حالت یک تست خودکار است که شکست می‌خورد.
  2. فرضیه: از مدل بخواهید چند علت محتمل را به ترتیب احتمال فهرست کند.
  3. آزمایش: برای هر فرضیه یک آزمایش کوچک (لاگ، یک assert، اجرای جداگانه) بخواهید.
  4. اصلاح: فقط وقتی علت روشن شد.
  5. تست رگرسیون: همان تست شکست‌خورده حالا باید سبز شود و بماند.
text
این تست شکست می‌خورد (خروجی کامل پایین است). هنوز کدی تغییر نده.
۱) سه علت محتمل را به ترتیب احتمال بگو.
۲) برای هر کدام یک آزمایش کوچک پیشنهاد بده که آن را رد یا تأیید کند.
[خروجی کامل تست]

ایجنت‌ها خودشان آزمایش می‌کنند

ایجنت‌های خط فرمان می‌توانند تست را اجرا کنند، لاگ اضافه کنند، خروجی را بخوانند و فرضیه‌ی بعدی را بسنجند. برای باگ‌هایی که فقط با اجرا معلوم می‌شوند، این بزرگ‌ترین مزیتشان است. فقط محدوده را مشخص کنید: «فقط در پوشه‌ی src/payments کار کن و پیش از تغییر کد اصلی، علت را گزارش بده».

پیدا کردن commit مقصر با git bisect

وقتی می‌دانید «تا هفته‌ی پیش کار می‌کرد»، git bisect با جست‌وجوی دودویی commit مقصر را پیدا می‌کند:

bash
git bisect start
git bisect bad              # نسخه‌ی فعلی خراب است
git bisect good v2.3.0      # این نسخه سالم بود
git bisect run ./run-failing-test.sh

سپس diff همان commit را به مدل بدهید؛ یافتن علت در یک تغییر کوچک بسیار ساده‌تر است.

سه دامی که باید مراقبشان باشید

  • سرکوب خطا به‌جای رفع علت: مدل گاهی دور کد try/catch می‌گذارد و خطا را بی‌صدا می‌کند. خطا ناپدید می‌شود، باگ نه.
  • تغییر تست به‌جای کد: اگر ایجنت برای سبز شدن، تست را حذف یا شل کرد، تغییر را رد کنید. در دستورالعمل پروژه صریحاً بنویسید «تست‌ها را برای پاس شدن تغییر نده».
  • اصلاح هم‌زمان چند چیز: اگر چند تغییر با هم اعمال شود، نمی‌دانید کدام مشکل را حل کرد. یکی‌یکی.

بعد از حل مشکل

از مدل بخواهید در دو جمله توضیح دهد علت چه بود و چرا این اصلاح درست است. اگر توضیحش قانع‌کننده نیست، احتمالاً علت اصلی هنوز پیدا نشده است.