nvim lspconfig

nvim-lspconfig

nvim-lspconfig عبارة عن مستودع "بيانات فقط"، يوفر تكوينات عميل Nvim LSP الأساسية والافتراضية لخوادم LSP المختلفة.

اعرض الوثائق الخاصة بجميع التكوينات أو :help lspconfig-all من Nvim.

مهم ⚠️

• إذا وجدت خطأً في وظيفة Nvim LSP ( :help lsp )، فأبلغ عنه إلى Neovim core.
  • لا تبلغ عنه هنا. فقط بيانات التكوين تعيش هنا.
• هذه التكوينات هي أفضل جهد ويدعمها المجتمع. انظر المساهمات.
• ملاحظة: يوفر هذا الريبو تكوينات فقط. تم إهمال واجهة برمجة التطبيقات البرمجية الخاصة بها ويجب عدم استخدامها خارجيًا.
  • تم التخطيط للعمل على رفع أجزاء "إطار العمل" بشكل انتقائي ( وليس التكوينات) من nvim-lspconfig إلى Nvim core وإهمالها في nvim-lspconfig.

ثَبَّتَ

• يتطلب Nvim 0.9 أعلاه. قم بتحديث Nvim وnvim-lspconfig قبل الإبلاغ عن مشكلة.
• قم بتثبيت nvim-lspconfig باستخدام ميزة "الحزم" الخاصة بـ Vim:

   git clone https://github.com/neovim/nvim-lspconfig ~/.config/nvim/pack/nvim/start/nvim-lspconfig
  

• أو استخدم مدير المكونات الإضافية التابع لجهة خارجية (راجع الوثائق الخاصة بمدير المكونات الإضافية لديك).

بداية سريعة

1. تثبيت خادم اللغة، على سبيل المثال pyright

   npm i -g pyright

2. أضف إعداد خادم اللغة إلى init.lua الخاص بك.

    require ' lspconfig ' . pyright . setup {}

3. تأكد من أن المشروع/مساحة العمل الخاصة بك تحتوي على علامة جذر تتوافق مع متطلبات الخادم المحددة في :help lspconfig-all .
4. افتح ملف التعليمات البرمجية في Nvim. سوف يقوم LSP بإرفاق وتوفير التشخيص.

    nvim main.py
   

5. قم بتشغيل :checkhealth lsp لمعرفة الحالة أو لاستكشاف الأخطاء وإصلاحها.

اقرأ :help lspconfig للحصول على التفاصيل. اقرأ :help lspconfig-all للحصول على القائمة الكاملة للتفاصيل الخاصة بالخادم. بالنسبة للخوادم غير الموجودة على $PATH (على سبيل المثال، jdtls ، elixirls ) ، يجب عليك تعيين المعلمة cmd يدويًا عند استدعاء setup() .

إعدادات

يقوم Nvim بتعيين بعض الخيارات والتعيينات الافتراضية عندما يتصل المخزن المؤقت بـ LSP (راجع :help lsp-config ). بخاصة:

• 'tagfunc'
  • تمكين إمكانيات "الانتقال إلى التعريف" باستخدام <C-]> وأوامر العلامات الأخرى.
• 'omnifunc'
  • تمكين إكمال الوضع متعدد الاتجاهات (يدويًا) باستخدام <CX><CO> في وضع الإدراج. للإكمال التلقائي ، مطلوب مكون إضافي للإكمال التلقائي.
• 'formatexpr'
  • تمكين تنسيق LSP باستخدام gq .
• يقوم K بتعيين vim.lsp.buf.hover() في الوضع العادي.
• [d و ]d يربطان vim.diagnostic.goto_prev() و vim.diagnostic.goto_next() على التوالي.
• يقوم <CW>d بتعيين vim.diagnostic.open_float() .

يمكن تحقيق المزيد من التخصيص باستخدام حدث الأوامر التلقائية LspAttach . يمكن استخدام حدث الأوامر التلقائية LspDetach "لتنظيف" التعيينات في حالة فصل المخزن المؤقت عن خادم LSP. راجع :h LspAttach و :h LspDetach للحصول على التفاصيل والأمثلة. راجع :h lsp-buf للحصول على تفاصيل حول وظائف LSP الأخرى.

يمكن توفير خيارات تكوين إضافية لكل خادم LSP عن طريق تمرير الوسائط إلى وظيفة setup . راجع :h lspconfig-setup للحصول على التفاصيل. مثال:

 local lspconfig = require ( ' lspconfig ' )
lspconfig . rust_analyzer . setup {
  -- Server-specific settings. See `:help lspconfig-setup`
  settings = {
    [ ' rust-analyzer ' ] = {},
  },
}

استكشاف الأخطاء وإصلاحها

الأسباب الأكثر شيوعًا لعدم بدء تشغيل خادم اللغة أو إرفاقه هي:

1. لم يتم تثبيت خادم اللغة. لا يقوم nvim-lspconfig بتثبيت خوادم اللغة لك. يجب أن تكون قادرًا على تشغيل cmd المحدد في وحدة Lua لكل خادم من سطر الأوامر والتأكد من بدء تشغيل خادم اللغة. إذا كان cmd اسمًا قابلاً للتنفيذ بدلاً من المسار المطلق للملف القابل للتنفيذ، فتأكد من وجوده على المسار الخاص بك.
2. المكونات الإضافية لنوع الملف مفقودة. لا يتم اكتشاف لغات معينة بواسطة Vim/Nvim لأنه لم تتم إضافتها بعد إلى نظام الكشف عن نوع الملف. تأكد :set ft? يظهر نوع الملف وليس قيمة فارغة.
3. لا يؤدي إلى الكشف عن الجذر. لن تبدأ بعض خوادم اللغات إلا إذا تم فتحها في دليل، أو دليل فرعي، يحتوي على ملف يشير إلى جذر المشروع. في معظم الأحيان، يكون هذا مجلدًا بتنسيق .git ، لكن كل خادم يحدد التكوين الجذري في ملف lua. راجع doc/configs.md أو المصدر للحصول على قائمة الدلائل الجذرية.
4. يجب عليك تمرير capabilities لكل setup {} إذا كنت تريد تفعيلها.
5. لا تقم باستدعاء setup {} مرتين لنفس الخادم . الاستدعاء الثاني setup {} سوف يحل محل الأول.

تقارير الأخطاء

إذا وجدت خطأً في وظيفة LSP، فأبلغ عنه إلى Neovim core.

قبل الإبلاغ عن خطأ ما، تحقق من سجلاتك ومخرجات :LspInfo . أضف ما يلي إلى init.vim الخاص بك لتمكين التسجيل:

 vim . lsp . set_log_level ( " debug " )

حاول تشغيل خادم اللغة، وافتح السجل باستخدام:

 :LspLog

في معظم الأحيان، يكون سبب الفشل موجودًا في السجلات.

الأوامر

• :LspInfo (الاسم المستعار المهمل لـ :che lspconfig ) يعرض حالة خوادم اللغة النشطة والمكونة.
• :LspStart <config_name> ابدأ اسم الخادم المطلوب. لن يبدأ بنجاح إلا إذا اكتشف الأمر دليلًا جذرًا يطابق التكوين الحالي. قم بتمرير autostart = false لاستدعاء .setup{} لخادم اللغة إذا كنت ترغب في تشغيل العملاء باستخدام هذا الأمر فقط. الإعدادات الافتراضية لجميع الخوادم التي تطابق نوع ملف المخزن المؤقت الحالي.
• :LspStop <client_id> الافتراضي هو إيقاف كافة عملاء المخزن المؤقت.
• :LspRestart <client_id> الافتراضي هو إعادة تشغيل كافة عملاء المخزن المؤقت.

المساهمات

إذا كان خادم اللغة مفقودًا من configs.md، فإن المساهمة بتكوين جديد له يساعد الآخرين، خاصة إذا كان الخادم يتطلب إعدادًا خاصًا. اتبع الخطوات التالية:

1. اقرأ CONTRIBUTING.md.
2. أنشئ ملفًا جديدًا على lua/lspconfig/configs/SERVER_NAME.lua .
   • انسخ التكوين الحالي للبدء. معظم التكوينات بسيطة. للحصول على مثال شامل، راجع texlab.lua.
3. اطرح أسئلة على مناقشات GitHub أو في غرفة Neovim Matrix.

عملية الإصدار

لنشر الإصدار:

• إنشاء ودفع علامة جديدة.
• بعد دفع العلامة، سيقوم إجراء GitHub تلقائيًا بحزم المكون الإضافي ونشر الإصدار إلى LuaRocks.

رخصة

حقوق الطبع والنشر للمساهمين Neovim. جميع الحقوق محفوظة.

تم ترخيص nvim-lspconfig بموجب شروط ترخيص Apache 2.0.

راجع LICENSE.md