ملف tsconfig

ملف tsconfig — tsconfig

tsconfig.json هو ملف إعداد مشروع TypeScript. يحدد للـ compiler أين توجد الملفات، ما مستوى JavaScript الناتج، وهل نستخدم strict mode. بدون هذا الملف، يصبح المشروع مجرد ملفات منفصلة. معه، يعرف المحرر والـ compiler قواعد العمل.

أهم خيار هو "strict": true. هذا يفعّل مجموعة فحوصات تجعل TypeScript أكثر فائدة. نعم، قد تظهر أخطاء أكثر في البداية، لكنها أخطاء تساعدك على الوضوح. إطفاء strict لتسريع البداية غالباً يؤجل الألم.

مثال إعداد حقيقي

tsconfig.json هو ملف JSON عادي. ضعه في جذر المشروع:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "noUncheckedIndexedAccess": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

أنشئه بأمر واحد داخل مجلد المشروع:

npx tsc --init

ثم عدّل الخيارات حسب احتياجك. استخدم extends لإعادة استخدام إعداد مشترك بين عدة مشاريع:

{ "extends": "@tsconfig/node20/tsconfig.json" }

لا تحفظ كل الخيارات

تعلم الخيارات الأساسية: target, module, strict, rootDir, outDir. ثم ارجع للتوثيق عند الحاجة.