TypeScript Tutorial فصل ۱ — شروع TypeScript درس آموزشی

tsconfig.json — تنظیمات سخت‌گیرانه پروژه

فایل tsconfig.json مغز تنظیمات پروژه است: به کامپایلر می‌گوید کجاها را چک کند، به چه نسخه‌ای از JS تبدیل کند و چقدر سخت‌گیر باشد. یک tsconfig استاندارد با strict:true خطاهای بیشتری در ابتدا می‌گیرد، اما در عوض کد شما قابل‌اعتمادتر می‌شود؛ همین تنظیمات است که تفاوت «TS برای نمایش» و «TS حرفه‌ای» را می‌سازد.

مراحل قدم‌به‌قدم

  1. ۱

    ساخت فایل با دستور

    npx tsc --init دستور رسمی ساخت tsconfig است؛ صدها گزینه (اغلب کامنت‌شده) می‌سازد. برای شروع این فایل را به نسخه تمیز درس تبدیل کنید.

  2. ۲

    مهم‌ترین گزینه‌ها

    strict همه چک‌های سخت‌گیرانه را یک‌جا روشن می‌کند؛ target نسخه JS خروجی را تعیین می‌کند (ES2020 گزینه خوبی است)؛ outDir پوشه خروجی می‌سازد (مثلاً dist)؛ rootDir پوشه سورس را مشخص می‌کند.

  3. ۳

    اجرای پروژه با tsc بدون آرگومان

    وقتی tsconfig.json وجود داشته باشد، فقط tsc بزنید؛ کل پروژه طبق تنظیمات کامپایل می‌شود. گزینه include یا exclude فایل‌ها را کنترل می‌کند.

  4. ۴

    اجرای مستقیم بدون کامپایل

    ابزار ts-node (یا tsx مدرن‌تر) فایل TS را بدون ساخت فایل JS اجرا می‌کند: npx tsx hello.ts. برای تست‌های سریع عالی است ولی در استقرار نهایی همیشه خروجی کامپایل‌شده JS را اجرا می‌کنید.

نکات مهم

  • ◆ strict:true را از روز اول روشن نگه دارید؛ خاموش‌کردنش بعداً برای دی‌بیگ کابوس می‌شود.
  • ◆ پوشه dist (خروجی کامپایل) را به .gitignore اضافه کنید.
  • ◆ noEmitOnError پیش‌فرض خوبی است: با خطا، فایل خروجی نساز.

کد یا مسیر نمونه

// tsconfig.json — نسخه تمیز و عملی
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "rootDir": "./src",
    "outDir": "./dist",
    "strict": true,
    "noEmitOnError": true
  },
  "include": ["src/**/*"]
}

/* ساختار پیشنهادی:
   پروژه/src/hello.ts  → کامپایل می‌شود به → پروژه/dist/hello.js
*/

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.