vscode go
Release
يوفر ملحق VS Code Go دعمًا غنيًا للغة البرمجة Go.
Visual Studio Code 1.75 أو الأحدث (أو المحررين المتوافقين مع VS Code 1.75+ APIs)
انتقل إلى 1.21 أو الأحدث.
مرحباً! ؟؟
سواء كنت جديدًا في Go أو أحد مطوري Go ذوي الخبرة، نأمل أن يناسب هذا الامتداد احتياجاتك ويعزز تجربة التطوير لديك.
قم بتثبيت Go 1.21 أو الأحدث إذا لم تقم بذلك بالفعل.
قم بتثبيت ملحق VS Code Go.
افتح أي ملف Go أو ملف go.mod لتنشيط الامتداد تلقائيًا. يظهر شريط الحالة Go في الركن الأيمن السفلي من النافذة ويعرض إصدار Go الخاص بك.
يعتمد الامتداد على go gopls (خادم لغة Go) والأدوات الاختيارية حسب إعداداتك. إذا كان gopls مفقودًا، فسيحاول الامتداد تثبيته. تشير علامة ⚡ الموجودة بجوار إصدار Go إلى أن خادم اللغة قيد التشغيل، وأنك جاهز للبدء.
(تثبيت الأدوات المفقودة)
أنت على استعداد للذهاب :-) ؟؟؟
اكتشف المزيد من ميزات ملحق VS Code Go.
اعرض وثائق الإعدادات والموضوعات المتقدمة لتخصيص الامتداد.
اعرض وثائق الأدوات للحصول على قائمة كاملة بالأدوات التي يعتمد عليها ملحق VS Code Go. يمكنك تثبيت أدوات إضافية وتحديثها باستخدام "Go: Install/Update Tools".
قم بحل المشكلات باستخدام الأدلة العامة لاستكشاف الأخطاء وإصلاحها وتصحيح الأخطاء.
تقديم مشكلة لمشاكل الامتداد.
ابدأ مناقشة GitHub أو احصل على مساعدة بشأن Stack Overflow.
استكشف موارد لغة Go على go.dev/learn وgolang.org/help.
إذا كنت جديدًا على Go، فإن هذه المقالة توفر نظرة عامة حول تنظيم كود Go وأوامر go الأساسية. شاهد "البدء مع VS Code Go" للحصول على شرح حول كيفية إنشاء أول تطبيق Go باستخدام VS Code Go.
التحسس الذكي - تظهر النتائج للرموز أثناء الكتابة.
التنقل في التعليمات البرمجية - انتقل إلى إعلان الرمز أو قم بإلقاء نظرة خاطفة عليه.
تحرير التعليمات البرمجية - دعم المقتطفات المحفوظة، والتنسيق وتنظيم التعليمات البرمجية، والتنظيم التلقائي لعمليات الاستيراد.
التشخيص - تظهر أخطاء البناء والفحص والوبر أثناء الكتابة أو عند الحفظ.
تعزيز الدعم للاختبار والتصحيح
راجع تفاصيل الميزات الكاملة لمزيد من التفاصيل.
(إكمال الكود والمساعدة في التوقيع)
بالإضافة إلى ميزات التحرير المتكاملة، يوفر الامتداد عدة أوامر للعمل مع ملفات Go. يمكنك الوصول إلى أي منها عن طريق فتح لوحة الأوامر ( Ctrl+Shift+P على Linux/Windows و Cmd+Shift+P على Mac)، ثم كتابة اسم الأمر. اطلع على القائمة الكاملة للأوامر التي يوفرها هذا الامتداد.
(تبديل ملف الاختبار)
لإبراز بناء الجملة بشكل أفضل، نوصي بتمكين التمييز الدلالي عن طريق تشغيل إعداد ui.semanticTokens الخاص بـ Gopls. "gopls": { "ui.semanticTokens": true }
يدعم ملحق VS Code Go كلاً من وضعي GOPATH وGo.
تُستخدم وحدات Go لإدارة التبعيات في الإصدارات الأخيرة من Go. تحل الوحدات محل النهج القائم على GOPATH لتحديد الملفات المصدر المستخدمة في بناء معين، وهي وضع البناء الافتراضي في go1.16+. نوصي بشدة بتطوير Go في وضع الوحدة النمطية. إذا كنت تعمل على مشاريع حالية، فيرجى التفكير في الانتقال إلى الوحدات النمطية.
على عكس وضع GOPATH التقليدي، لا يتطلب وضع الوحدة النمطية تحديد موقع مساحة العمل ضمن GOPATH أو استخدام بنية محددة. يتم تعريف الوحدة من خلال شجرة دليل لملفات مصدر Go مع ملف go.mod في الدليل الجذر للشجرة.
قد يتضمن مشروعك وحدة واحدة أو أكثر. إذا كنت تعمل باستخدام وحدات نمطية متعددة أو تخطيطات مشروع غير شائعة، فستحتاج إلى تكوين مساحة العمل الخاصة بك باستخدام مجلدات مساحة العمل. راجع وثائق تخطيطات مساحة العمل المدعومة لمزيد من المعلومات.
إذا كنت ترغب في الوصول مبكرًا إلى الميزات الجديدة وإصلاحات الأخطاء، فيمكنك استخدام ملحق الإصدار التجريبي. باتباع تقليد vscode، نستخدم الإصدار الثانوي من رقم إصدار الامتداد للتمييز بين الإصدارات الثابتة وما قبل النشر ( 0.ODD_NUMBER.patch للإصدار المسبق، 0.EVEN_NUMBER.patch للإصدار المستقر).
لتثبيت إصدار ما قبل النشر، استخدم القائمة المنسدلة لتحديد "تثبيت إصدار ما قبل الإصدار"، أو إذا قمت بالفعل بتثبيت ملحق Go، فاستخدم خيار "التبديل إلى إصدار ما قبل الإصدار" في إدارة ملحق Visual Studio Code صفحة. لمزيد من التفاصيل حول هذه الآلية، راجع وثائق Visual Studio Code.
يعتمد ملحق VS Code Go على Go Telemetry للتعرف على رؤى حول أداء واستقرار الامتداد وخادم اللغة ( gopls ). يتم تعطيل تحميل بيانات Go Telemetry افتراضيًا ويمكن تمكينه باستخدام الأمر التالي:
go run golang.org/x/telemetry/cmd/gotelemetry@latest on
بعد تمكين القياس عن بعد، سيقوم خادم اللغة بتحميل المقاييس وتكديس التتبعات إلى telemetry.go.dev. يمكنك فحص البيانات التي تم جمعها والتي يمكن تحميلها عن طريق تشغيل:
go run golang.org/x/telemetry/cmd/gotelemetry@latest view
إذا حصلنا على ما يكفي من الاعتماد، فيمكن لهذه البيانات أن تعزز بشكل كبير وتيرة تطوير ملحق Go، وتساعدنا على تلبية مستوى أعلى من الموثوقية. على سبيل المثال:
حتى مع تقارير الأعطال شبه الآلية في VS Code، فقد رأينا العديد من الأعطال لا يتم الإبلاغ عنها لأسابيع أو أشهر.
حتى مع وجود مجموعة من معايير الأداء، لا تظهر بعض تراجعات الأداء في بيئة قياس الأداء لدينا (مثل خطأ الإكمال المذكور أدناه!).
حتى مع وجود الكثير من الأفكار الرائعة حول كيفية تحسين مستوى gopls، إلا أن مواردنا محدودة. يمكن أن يساعدنا القياس عن بعد في تحديد الميزات الجديدة الأكثر أهمية، والميزات الموجودة التي لا يتم استخدامها أو التي لا تعمل بشكل جيد.
هذه مجرد بعض الطرق التي يمكن للقياس عن بعد من خلالها تحسين مستوى gopls. تحتوي سلسلة منشورات مدونة القياس عن بعد على المزيد.
تم تصميم Go Telemetry ليكون شفافًا ويحافظ على الخصوصية. تعرف على المزيد على https://go.dev/doc/telemetry.
تتم صيانة ملحق Go بواسطة مهندسين في فريق أدوات Go، الذين يراقبون بشكل نشط أدوات تعقب مشكلات VS Code Go وGo.
نحن ندعم فقط أحدث الإصدارات الثابتة وما قبل النشر من الامتداد.
يتبع ملحق Go سياسة إصدار Go، مما يعني أنه يدعم رسميًا أحدث إصدارين رئيسيين من Go. يحتفظ فريق Go بدعم أفضل الجهود لآخر ثلاثة إصدارات رئيسية من Go.
يعتمد ملحق Go على أدوات مثل gopls و dlv في وظائفه الأساسية ولديه سياسة الإصدار والجدول الزمني الخاص به. نحن نختبر فقط أحدث الإصدارات من هذه الأدوات.
إذا كنت بحاجة إلى العمل مع إصدار أقدم من Go، فيرجى التحقق من صفحة التوافق وتثبيت الإصدار المتوافق من الامتداد والأدوات يدويًا.
نرحب بمساهماتك ونشكرك على العمل على تحسين تجربة تطوير Go في VS Code. إذا كنت ترغب في المساعدة في العمل على ملحق VS Code Go، راجع دليل المساهمة الخاص بنا لمعرفة كيفية إنشاء ملحق VS Code Go وتشغيله محليًا والمساهمة في المشروع.
يتبع هذا المشروع قواعد سلوك مجتمع Go. إذا واجهت مشكلة تتعلق بالسلوك، يرجى إرسال بريد إلكتروني إلى [email protected].
معهد ماساتشوستس للتكنولوجيا
