كيف تنشئ مقتطفات الشيفرة وتديرها في VS Code
في هذه الصفحة 5 قسم
الإجابة المختصرة: المقتطفات مدمجة في VS Code: شغّل Snippets: Configure Snippets، واختر لغة أو ملف مشروع، واكتب كل مقتطف بصيغة JSON مع prefix وbody. ولعمل أسرع، حدّد شيفرة واحفظها كمقتطف في ثوانٍ باستخدام Create Snippet في DevSnip Pro، واستخدم مقتطفاته ds- لـ Spring Boot وASP.NET Core وFastAPI وReact وNext.js وFlutter وSwiftUI.
المقتطف الجيد يوفّر أكثر من ضغطات المفاتيح. إنه يحفظ نسخة من نمط سبق أن صحّحته: معالج الأخطاء برموز الحالة الصحيحة، والاختبار بالإعداد الصحيح، وغلاف fetch الذي يتحقق من response..
| النطاق | الملف | استخدمه من أجل |
|---|---|---|
| لغة واحدة | typescript. في مجلد مقتطفات المستخدم | مقتطفات شخصية للغة واحدة |
| عام | *. في مجلد مقتطفات المستخدم | مقتطفات شخصية لعدة لغات |
| المشروع | . في المستودع | مقتطفات الفريق، محفوظة مع الشيفرة |
افتح أيًّا منها عبر Snippets: Configure Snippets (وفي الإصدارات الأقدم Preferences: Configure User Snippets) من لوحة الأوامر، Ctrl/Cmd+Shift+P.
المقتطف إدخال مسمّى يضم النص الذي تكتبه (prefix)، والأسطر التي يدرجها (body)، وdescription اختياريًا يظهر في IntelliSense:
{
"Express route handler": {
"prefix": "exroute",
"scope": "javascript,typescript",
"body": [
"router.${1|get,post,put,delete|}('/${2:path}', async (req, res, next) => {",
" try {",
" $0",
" } catch (err) {",
" next(err);",
" }",
"});"
],
"description": "Async Express route that passes errors to next()"
}
}الصيغة التي تجعل المقتطفات مفيدة:
$1و$2… هي نقاط التوقف: ينقلك Tab بينها، و$0هو مكان انتهاء المؤشر.${1:path}هو عنصر نائب بنص افتراضي يمكنك الكتابة فوقه.${1|get,post,put,delete|}هو اختيار: قائمة منسدلة من القيم.- المتغيرات مثل
$TM_FILENAME_BASEو$CURRENT_YEARو$CLIPBOARDتدرج السياق. ويحوّل${TM_FILENAME_BASE/(. *)/ ${1:/ pascalcase}/ } user-cardإلىUserCard. scope(في ملفات.) يقصر المقتطف على بعض اللغات.code-snippets
داخل body، اكتب $ الحرفية بالصيغة \\$، و} داخل العنصر النائب بالصيغة \\}.
كتابة JSON يدويًا مع علامات الاقتباس المهرّبة هي الجزء البطيء. مع DevSnip Pro:
- حدّد الشيفرة التي تريد إعادة استخدامها.
- شغّل DevSnip Pro: Create Snippet.
- أدخل البادئة التي ستكتبها، واسمًا، ووصفًا اختياريًا.
- أعد تحميل النافذة عند الطلب. يحمّل VS Code المقتطفات المضافة عند بدء التشغيل.
يظهر المقتطف بعد ذلك في IntelliSense بتلك اللغة (39 لغة مدعومة). وإذا كانت البادئة مستخدمة في مقتطف آخر لديك، يُطلب منك التأكيد أولًا، فلا ينتهي بك الأمر بمقتطفين يظهران معًا. ويعرض DevSnip Pro: Saved Snippets كل ما حفظته ويحذف ما لم تعد تستخدمه.
اكتب ds- في ملف مدعوم، أو شغّل DevSnip Pro: Framework Snippets للاختيار من قائمة. هناك 56 مقتطفًا، وسّع VS Code كلًّا منها ثم تُرجم (وشُغّل حيث يسمح إطار العمل)، فهي تعمل كما تُدرج:
- Spring Boot:
ds-rest-controllerوds-serviceوds-entityوds-repositoryوds-controller-adviceوds-webmvctestوds-junit - ASP.NET Core:
ds-minimal-apiوds-api-controllerوds-exception-handlerوds-dbcontextوds-xunitوds-webapp-test - Python:
ds-fastapi-appوds-fastapi-routerوds-pydanticوds-flask-routeوds-django-viewوds-pytestوds-pytest-fixture - React وNext.js:
ds-rfcوds-hookوds-contextوds-next-pageوds-next-routeوds-server-actionوds-rtl - TypeScript وNode.js:
ds-express-routerوds-express-errorوds-zodوds-fetch-jsonوds-vitest - Flutter وSwiftUI:
ds-stlessوds-stfulوds-future-builderوds-swiftui-viewوds-view-model
ولـ Java وC# وPython وSwift أيضًا مقتطف ds-logger. ينشئ المُسجّل الذي يستخدمه Insert Debug Log بعد ذلك لأسطر التصحيح.
- سمِّ البادئات بما تنتجه، لا بمصدرها:
exrouteأفضل منsnippet3. والبداية المشتركة (مثلds-) تجمعها في IntelliSense. - أبقِ المقتطفات صغيرة. المقتطف الذي يولّد ملفًا كاملًا يصعب تكييفه؛ وحين تحتاج إلى مورد كامل، يكون المولّد أنسب. ينشئ API Resource Scaffolder في DevSnip Pro واجهة CRUD موثّقة مع تقسيم الصفحات لـ Express أو NestJS أو Next.js أو Fastify أو Spring Boot أو ASP.NET Core أو FastAPI.
- شارك مقتطفات الفريق عبر المستودع. يُدار ملف
.بالإصدارات ويُراجَع كالشيفرة، ويحصل عليه كل من يفتح المشروع.vscode/ project. code-snippets - نظّف. إذا لم تستخدم مقتطفًا منذ أشهر، فاحذفه ليسهل العثور على ما تستخدمه فعلًا.