كيف تزيل عبارات console.log من مشروع في VS Code

بقلم Sayaib Sarkarآخر تحديث قراءة في 4 دقيقة

في هذه الصفحة 6 قسم

الإجابة المختصرة: يصلح «استبدال الكل» بتعبير نمطي في بحث VS Code للاستدعاءات البسيطة ذات السطر الواحد، لكنه يحذف أيضًا الشيفرة التي تشاركها السطر ويفوّت الاستدعاءات الممتدة على عدة أسطر. وللتنظيف الآمن، استخدم أداة تفهم التعليقات والسلاسل النصية ولا تزيل إلا العبارات القائمة وحدها، ثم أضف قاعدة ESLint لالتقاط الجديد منها في المراجعة. تتولى Clean Debug Logs في DevSnip Pro الجزء الأول لـ JavaScript وTypeScript وPython وJava وKotlin وC#‎ وDart وSwift.

سجلات التصحيح أسرع طريقة لترى قيمة ما على حقيقتها. المشكلة في التنظيف: فـ console.log منسي يسرّب البيانات إلى وحدة تحكم المتصفح، وprint شارد يملأ سجلات الإنتاج، وتعقّبها يدويًا قبل كل commit أمر مرهق.

الخيار 1: البحث والاستبدال بتعبير نمطي (سريع، مع تحفظات)

افتح البحث عبر الملفات بـ Ctrl/Cmd+Shift+H، وفعّل التعابير النمطية بزر .*، وابحث عن:

Text
^[ \t]*console\.log\([^;\n]*\);?[ \t]*\n

اترك Replace فارغًا، وراجع التطابقات في الشريط الجانبي، ثم استبدل. لا يطابق النمط إلا استدعاءً يملأ سطره كاملًا ويتوقف عند أول فاصلة منقوطة، فلا يمكنه حذف شيفرة تلي السجل في السطر نفسه. والثمن أن السجلات التي تحتوي على ; (داخل سلسلة نصية مثلًا) تُتخطى.

ومع ذلك فله حدود:

  • الاستدعاءات متعددة الأسطر مثل console.log(\n user,\n order\n) لا تطابق، فتبقى في مكانها.
  • التعليقات والسلاسل النصية تطابق أيضًا: فيُحذف سطر داخل template literal أو مثال معلّق.
  • قد تبقى كتل فارغة. في Python، إزالة print الوحيد في جسم if تسبب خطأ صيغة.
  • لا يغطي إلا لغة واحدة واسم دالة واحدًا في كل بحث.

استخدم حقل files to include (مثل src/**) لإبعاده عن node_modules والملفات المولّدة والشيفرة الخارجية المضمّنة.

الخيار 2: ‏Clean Debug Logs في DevSnip Pro

شغّل DevSnip Pro: Clean Debug Logs من لوحة الأوامر (Ctrl/Cmd+Shift+P). يفحص مساحة العمل ويعرض ما عثر عليه قبل تغيير أي شيء:

  • console.log وprint وpprint وbreakpoint() وSystem.out.println وLog.d وConsole.WriteLine وDebug.WriteLine وdebugPrint وNSLog وdump وما يشبهها، بما في ذلك داخل كتل <script> في ملفات HTML وVue وSvelte وPHP.
  • تُتجاهل الاستدعاءات داخل التعليقات والسلاسل النصية.
  • لا تُزال إلا العبارات القائمة وحدها في أسطرها. أما الاستدعاء الذي يشارك سطرًا، أو يكمل تعبيرًا، أو يمثل جسم if دون أقواس، فيُعرض للمراجعة بدلًا من حذفه.
  • تبقى الشيفرة صالحة: كتلة Python التي تصبح فارغة تحصل على pass، وcase في Swift أو Dart الذي يصبح فارغًا يحصل على break. وتُحفظ نهايات الأسطر.

يطلب التأكيد قبل الحذف؛ ويتحكم في ذلك الإعداد devsnip.consoleLogCleanup.confirmBeforeDelete. وللملف المفتوح وحده، شغّل Remove Debug Logs in This File، ويعيده Undo إن غيّرت رأيك.

تسجيلك الحقيقي في أمان: لا تُمس الاستدعاءات عبر مُسجّل مشروعك (logger.info و_logger.LogInformation وغيرها) ما لم يكن DevSnip Pro قد كتبها بنفسه.

اكتب سجلات تصحيح يسهل العثور عليها مجددًا

نصف مشكلة التنظيف سجلات تبدو كشيفرة حقيقية. يسجّل Insert Debug Log ‏(Ctrl+Alt+Shift+L) المتغير الموجود تحت المؤشر مع وسم [file:line]، في المكان الصحيح: بعد الإسناد، أو في أعلى الدالة للمعامل، أو في أعلى الحلقة لمتغيرها.

TypeScript
const total = items.reduce((sum, item) => sum + item.price * item.qty, 0);
console.log('[cart.ts:14] total:', total);

وإذا كان في الملف مُسجّل بالفعل، فإنه يستخدمه بدلًا من print أو console.log:

Python
total = sum(item.price * item.qty for item in items)
logger.debug("[orders.py:12] total=%r", total)

ولأن كل سجل مُدرج يحمل وسمه، يتعرّف عليه Clean Debug Logs ويزيله لاحقًا، حتى عندما يمر عبر مُسجّل المشروع.

الخيار 3: امنع الجديد منها عند المراجعة

أدوات التنظيف تصلح سجلات اليوم. وقاعدة الفحص تمنع سجلات الغد. مع إعداد flat في ESLint:

JavaScript
// eslint.config.js
export default [
  {
    rules: {
      'no-console': ['warn', { allow: ['warn', 'error'] }],
    },
  },
];

يشير هذا إلى console.log مع السماح بـ console.warn وconsole.error، اللذين يكونان مقصودين عادةً. شغّل ESLint في التكامل المستمر ليُفشل السجلُ الشاردُ الفحصَ بدلًا من أن يصل إلى الإنتاج. ويمكن لمشاريع Python فعل الشيء نفسه بقواعد T20 في Ruff ‏(flake8-print)، التي تشير إلى print وpprint.

وماذا عن إزالة السجلات وقت البناء؟

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

روتين ناجح

  1. صحّح باستخدام سجلات موسومة (Insert Debug Log)، ليسهل رصدها.
  2. قبل الحفظ في المستودع، شغّل Clean Debug Logs، واقرأ القائمة، وراجع كل ما أشار إليه بدلًا من إزالته.
  3. دع ESLint أو Ruff يلتقط في التكامل المستمر كل ما فاتك.

جرّبه في محررك

مجاني، دون حساب، ويعمل محليًا. لـ VS Code 1.93 أو أحدث وبيئات JetBrains على Windows أو macOS أو Linux.

code --install-extension sayaib.hue-console