انتقل إلى المحتوى الرئيسي

استكشاف مشكلات قراءة قاعدة الكود وإصلاحها

معلومات

إذا كان Cursor يواجه مشكلة في قراءة قاعدة الكود أو الملفات الخاصة بك، اتبع هذا الدليل لحل المشكلات الشائعة.

الأعراض الشائعة​

  1. لا يستطيع Cursor رؤية ملفات المشروع
  2. ميزات الذكاء الاصطناعي لا تعمل مع قاعدة الكود
  3. شجرة الملفات لا تتحدث
  4. وظيفة البحث لا تعمل

حلول سريعة​

1. تحديث شجرة الملفات​

الحل الأسرع غالبًا هو تحديث شجرة الملفات:

  1. انقر بزر الماوس الأيمن على مستكشف الملفات
  2. اختر "تحديث"
  3. انتظر حتى تتحدث شجرة الملفات

2. التحقق من أذونات الملفات​

  1. انقر بزر الماوس الأيمن على مجلد المشروع
  2. اختر "خصائص"
  3. انتقل إلى علامة التبويب "الأمان"
  4. تأكد من أن المستخدم لديه أذونات "قراءة" و"كتابة"

3. التحقق من .gitignore و .cursorignore​

في بعض الأحيان يتم تجاهل الملفات عمدًا. تحقق من:

  1. محتويات ملف .gitignore
  2. محتويات ملف .cursorignore
  3. إزالة أي أنماط لا ينبغي تجاهلها

حلول متعمقة​

مشكلات مراقب نظام الملفات​

إذا كان Cursor لا يكتشف تغييرات الملفات:

.vscode/settings.json
{
  "files.watcherExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true,
    // أضف دلائل أخرى تريد استبعادها
  }
}

التعامل مع قواعد الكود الكبيرة​

لقواعد الكود الكبيرة:

  1. زيادة حد الذاكرة

    .cursor/settings.json
    {
      "files.maxMemoryForLargeFilesMB": 4096
    }

  2. تحسين مراقبة الملفات

    • استبعاد الدلائل غير الضرورية
    • استخدام ميزات ثقة مساحة العمل
    • النظر في استخدام تخزين مساحة العمل

مشكلات تكامل Git​

إذا كانت الميزات المتعلقة بـ Git لا تعمل:

  1. تحقق من تثبيت Git:

    git --version

  2. تحقق من تكوين Git:

    git config --list

  3. إعادة تعيين ذاكرة التخزين المؤقت لـ Git:

    git rm -r --cached .
    git add .

نصائح للوقاية​

  1. بنية مشروع نظيفة

    • تنظيم الملفات بشكل منطقي
    • استخدام .gitignore مناسب
    • الحفاظ على نظافة الدليل الجذر

  2. صيانة منتظمة

    • مسح ذاكرة التخزين المؤقت للمحرر بانتظام
    • تحديث Cursor بشكل متكرر
    • مراقبة موارد النظام

  3. تحسين الأداء

    • استبعاد الملفات الثنائية الكبيرة
    • استخدام تخزين مساحة العمل
    • تنفيذ أنماط تجاهل مناسبة

استكشاف الأخطاء المتقدم​

التسجيل والتشخيص​

تمكين التسجيل المفصل:

  1. افتح لوحة الأوامر (Ctrl/Cmd + Shift + P)
  2. اكتب "Developer: Set Log Level"
  3. اختر "Trace"

إعادة تعيين ذاكرة التخزين المؤقت​

إذا استمرت المشكلات:

  1. أغلق Cursor
  2. احذف دلائل ذاكرة التخزين المؤقت:
    • Windows: %APPDATA%\Cursor\Cache
    • macOS: ~/Library/Application Support/Cursor/Cache
    • Linux: ~/.config/Cursor/Cache
  3. أعد تشغيل Cursor

ثقة مساحة العمل​

تكوين ثقة مساحة العمل:

  1. افتح لوحة الأوامر
  2. ابحث عن "Workspace Trust"
  3. قم بتكوين إعدادات الثقة لمشروعك

متى تتصل بالدعم​

اتصل بدعم Cursor إذا:

  1. استمرت المشكلات بعد تجربة جميع الحلول
  2. واجهت فقدان بيانات
  3. تدهور الأداء بشكل كبير
  4. وجدت مخاوف أمنية
تلميح

احتفظ بسجلات الأخطاء ومعلومات النظام جاهزة عند الاتصال بالدعم

الموارد ذات الصلة​