افحص ميزات إكمال الكود في GitHub Copilot

مكتمل

GitHub Copilot يقدم اقتراحات بأسلوب الإكمال التلقائي عند إدخال الكود. بالإضافة إلى اقتراحات الإكمال التلقائي القياسية، يوفر GitHub Copilot أيضا اقتراحات للتعديل التالي (NES)، التي تتنبأ بموقع التعديل التالي الذي من المحتمل أن تقوم به وتقترح إكمالها.

تتلقى اقتراحات نمط الإكمال التلقائي عند تنفيذ الإجراءات التالية:

• أدخل سطر تعليمة برمجية جزئية أو كاملة في المحرر.
• أدخل تعليقا جزئيا أو كاملا على التعليمات البرمجية في المحرر.
• أدخل سطر تعليمة برمجية فارغا في المحرر.

بعد ذلك، تظهر اقتراحات التعديل تلقائيا أثناء تحرير الكود. تتنبأ هذه التعديلات بالتغيير الذي من المحتمل أن تقوم به بعد ذلك بناء على تعديلاتك الأخيرة وتعرض بمؤشر خاص يوضح موقع التعديل المقترح.

إنشاء اقتراح الإكمال التلقائي

GitHub Copilot يسرع تطوير التطبيقات من خلال اقتراح إكمال الكود بناء على الكود الذي تكتبه.

على سبيل المثال، افترض أنك تريد إنشاء طريقة C# تسمى addInt تعيد مجموع عددين صحيحين. إذا بدأت بكتابة توقيع الطريقة، GitHub Copilot يقترح الكود الذي يعتقد أنك تريد إنشائه.

يتم عرض الإكمال التلقائي المقترح دون تمييز بناء الجملة الملون. يساعد هذا في تمييز الإكمال التلقائي عن التعليمات البرمجية الموجودة. يمكنك قبول التعليمات البرمجية المقترحة بالضغط على المفتاح Tab.

يمكنك الضغط على مفتاح Esc لتجاهل اقتراح.

مثال addInt مبسط بعض الشيء، لذا قد تتساءل كيف GitHub Copilot مع شيء أكثر تعقيدا.

لنفترض أنك تريد إنشاء أسلوب يقبل قائمة الأرقام ويعيد مجموع الأعداد الأولية المضمنة في القائمة. يمكنك تسمية الطريقة addPrimeNumbersInNumericList. عندما تبدأ في كتابة توقيع الطريقة، GitHub Copilot يولد لك اقتراحا. على سبيل المثال:

من المهم مراجعة الاقتراحات قبل قبولها. يبدو هذا الإكمال التلقائي جيدا، لذا يمكنك قبول الاقتراح بالضغط على المفتاح Tab.

دعونا نواصل السيناريو أكثر قليلا.

بمجرد دمج الاقتراح في الكود، تلاحظ أن الطريقة isPrime محددة تحتها باللون الأحمر. وذلك لأن هذه isPrime الطريقة غير موجودة في الكود بعد.

GitHub Copilot مدربا على اتباع أفضل الممارسات، والتي تشمل تقسيم المشكلات المعقدة إلى أجزاء أصغر وأكثر قابلية للإدارة. في هذه الحالة، GitHub Copilot يقترح أن تنشئ طريقة منفصلة isPrime للتحقق مما إذا كان الرقم أوليا.

GitHub Copilot جاهز يقترح مقتطفا كودا لطريقة isPrime. عندما تدخل سطرا فارغا تحت طريقة addPrimeNumbersInNumericList، GitHub Copilot يقترح طريقة isPrime يمكنك استخدامها.

تسرع اقتراحات الإكمال التلقائي عملية التطوير من خلال توفير مقتطفات التعليمات البرمجية. ولكن ماذا لو كانت الاقتراحات ليست تماما ما تحتاجه؟ يوفر GitHub Copilot واجهة لإدارة اقتراحات الإكمال التلقائي.

إدارة اقتراحات الإكمال التلقائي

عندما يقترح GitHub Copilot إكمال تلقائي، فإنه يوفر أيضا واجهة لإدارة الاقتراحات. يمكنك قبول اقتراح أو مراجعة اقتراحات أخرى أو تجاهل الاقتراحات.

عند تمرير مؤشر الماوس فوق الإكمال التلقائي المقترح، يتم تقديم عدة خيارات لإدارة الاقتراحات.

تتضمن الواجهة الافتراضية لإدارة الاقتراحات الخيارات التالية:

• اقبل الاقتراح (بالكامل) باختيار القبول. يمكنك أيضا قبول الاقتراح بالضغط على المفتاح Tab.
• اقبل الاقتراح جزئيا باختيار قبول Word. يمكنك أيضا قبول اقتراح جزئيا بالضغط على Ctrl + → مفاتيح السهم (على اليمين).
• عرض الاقتراحات البديلة باختيار > أو <. يمكنك أيضا عرض الاقتراحات البديلة بالضغط Alt] + على مفاتيح or[Alt + .

اختيار خيار قبول Word يقبل word التالي في الاقتراح. يكون هذا مفيدا عندما تريد قبول جزء من الاقتراح ثم متابعة كتابة التعليمات البرمجية الخاصة بك. على سبيل المثال، يمكنك قبول الكلمة الأولى من isPrime اقتراح الطريقة.

استمر في اختيار قبول Word حتى تقبل الاقتراح كما تريد.

اختيار أيقونة الحذف الناقص (...) على يمين زر قبول Word يوفر خيارات إضافية مثل Always Show Toolbar و Open Completeions Panel.

اختيار خيار شريط الأدوات "دائما أظهر " يضمن بقاء شريط الأدوات مرئيا عند استخدام اختصارات لوحة المفاتيح لإدارة اقتراحات الإكمال التلقائي. اختيار خيار Open Completeions Panel يفتح لوحة GitHub Copilot الإكمال. يتم تغطية عرض عدة اقتراحات باستخدام لوحة GitHub Copilot Completeions في نهاية هذه الوحدة.

‏‫ملاحظة‬

لقبول سطر كامل من الاقتراح، تحتاج إلى تكوين اختصار مخصص للوحة المفاتيح للأمر editor.action.inlineSuggest.acceptNextLine . هذا الخيار غير متوفر افتراضيا في شريط الأدوات.

إنشاء اقتراحات التعليمات البرمجية من التعليقات

بالإضافة إلى اقتراح إكمال تلقائي بناء على الكود، يمكن GitHub Copilot استخدام تعليقات الكود لاقتراح مقتطفات من الكود. استخدم عبارات اللغة الطبيعية لوصف التعليمات البرمجية التي تريد إنشاؤها. هذا يمكن GitHub Copilot من اقتراح اقتراحات الإكمال التلقائي التي تلبي متطلبات محددة. على سبيل المثال، يمكنك تحديد نوع الخوارزمية التي تريد استخدامها في عملية حسابية، أو الأساليب والخصائص التي تريد إضافتها إلى فئة.

لنعد إلى مثال الرقم الرئيسي. عند هذه النقطة، لديك التعليمات البرمجية التالية:

يبدو أن addPrimeNumbersInNumericList طرق و isPrime مكتملة. ومع ذلك، لا تزال بحاجة إلى قائمة أرقام يمكن استخدامها كوسيطة عند استدعاء addPrimeNumbersInNumericList الطريقة. يمكنك كتابة تعليق يصف قائمة الأرقام التي تريدها. على سبيل المثال، قائمة مكونة من 100 رقم عشوائي تتراوح بين 1 و1000.

عندما تبدأ بإدخال التعليق، يقترح GitHub Copilot إكمال تلقائي يكمل التعليق نيابة عنك. GitHub Copilot يستخدم الكود المحيط لتحسين اقتراحاته. على سبيل المثال، إذا بدأت بإدخال التعليق // create، GitHub Copilot يستخدم الكود المحيط للتنبؤ بما تريد إنشاؤه. في هذه الحالة، يستخدم GitHub Copilot طريقة addPrimeNumbersInNumericList للتنبؤ بأنك تريد إنشاء a list of numbers.

بينما تواصل كتابة تعليقك، يقوم GitHub Copilot بتحديث اقتراح الإكمال التلقائي. عندما تكون مستعدا لقبول الاقتراح، اختر قبول أو اضغط على زر التبويب.

عندما تنشئ سطر كود جديد بعد التعليق، يبدأ GitHub Copilot في إنشاء مقتطف كود بناء على التعليق وكودك الحالي.

اقبل كل اقتراح من الاقتراحات كما تظهر.

إذا لم يتم GitHub Copilot ذلك، فإنه يولد اقتراحا آخر لتقبله.

إذا أدخلت سطر كود جديد بعد اكتمال مقطع الكود، GitHub Copilot يولد اقتراحات إكمال تلقائي أخرى بناء على متطلبات مشروع الكود الخاص بك. في هذه الحالة، يقترح GitHub Copilot سطر رمز يستدعي طريقة addPrimeNumbersInNumericList، ويمرر القائمة المسماة numbers.

عرض عدة اقتراحات باستخدام لوحة GitHub Copilot Completeions

إذا لم تكن راضيا عن اقتراحات الإكمال التلقائي الأولية، يمكنك GitHub Copilot فتح تبويب جديد في المحرر مع خيارات أكثر. يمكنك مراجعة قائمة الاقتراحات الأكبر للعثور على تطابق أفضل، ثم تحديدها.

لإظهار هذه الميزة، دعنا نعود إلى مرحلة سابقة في مثال الأعداد الأولية.

افترض أنك لا تزال بحاجة لإنشاء الطريقة isPrime . عندما تدخل سطرا فارغا أسفل طريقة addPrimeNumbersInNumericList، GitHub Copilot يقترح لك طريقة isPrime. هذه هي العملية نفسها التي استخدمتها سابقا. ومع ذلك، لنفترض أنك غير راض عن الاقتراحات التي يقدمها GitHub Copilot وترغب في رؤية المزيد من الخيارات.

لفتح لوحة GitHub Copilot Completeions وعرض اقتراحات أخرى، اضغط على مفاتيح Ctrl + Enter. يمكنك أيضا فتح قائمة المزيد من الإجراءات واختيار لوحة فتح الإكمال.

تعرض لوحة GitHub Copilot الإكمال ما يصل إلى 10 اقتراحات أخرى. راجع الاقتراحات للعثور على الاقتراح الذي يناسب احتياجاتك بشكل أفضل.

لقبول اقتراح، اختر تسمية رقم قبول الاقتراح أسفل الاقتراح. على سبيل المثال، اختر تسمية قبول الاقتراح 1 أسفل الاقتراح الأول.

لرفض كل الاقتراحات، أغلق علامة التبويب.

ملخص

اقتراحات الإكمال التلقائي واقتراحات التعديل التالية تساعدك على كتابة الكود بشكل أكثر كفاءة ودقة. GitHub Copilot يقدم اقتراحات للإكمال التلقائي عند إدخال الرمز، واقتراحات تعديل لاحق تتنبأ بتعديلك المحتمل القادم. يمكنك إنشاء اقتراح الإكمال التلقائي عن طريق إدخال سطر تعليمة برمجية جزئي أو كامل أو تعليق رمز جزئي أو كامل أو سطر تعليمات برمجية فارغ. يمكنك قبول اقتراح بالضغط على المفتاح Tab، أو تجاهل الاقتراحات بالضغط على المفتاح Esc. يمكنك إدارة الاقتراحات باستخدام شريط الأدوات الذي يظهر عند تمرير الماوس فوق اقتراح. تتيح لك شريط الأدوات مراجعة اقتراحات بديلة، أو قبول اقتراح، أو قبول كلمة واحدة من اقتراح، أو فتح لوحة GitHub Copilot لإكمالها لعرض المزيد من الاقتراحات.