Series: TypeScript Basics Lesson 76

Path aliases

TypeScript'da path alias'lar: uzun ../../../ yo'llarni qisqa @/ bilan almashtirish, tsconfig'da paths sozlash, bundler'ni ham sozlash zarurati, Vite va Next.js misollari.

76-dars

Path aliases

Path alias — bu uzun yo'lga qisqa taxallus berish. ../../../ o'rniga loyiha papkasiga to'g'ridan-to'g'ri ishora qilasiz.

Hayotiy o'xshatish: telefondagi kontakt. Har safar raqamni terish o'rniga "Onam" deb bosasiz.

Muammo

// src/features/cart/components/CartItem.tsx
import { Button } from "../../../components/Button";
import { formatPrice } from "../../../utils/format";

Faylni boshqa papkaga ko'chirsangiz, bu yo'llarning hammasi buziladi.

Yechim

import { Button } from "@/components/Button";
import { formatPrice } from "@/utils/format";

@ — bu src papkasi degani. Fayl qayerda bo'lishidan qat'i nazar, yo'l bir xil.

Sozlash: tsconfig.json

{
  "compilerOptions": {
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

Bir nechta alias ham qo'yish mumkin:

{
  "compilerOptions": {
    "paths": {
      "@/*": ["./src/*"],
      "@components/*": ["./src/components/*"],
      "@utils/*": ["./src/utils/*"]
    }
  }
}

⚠️ Eng muhim nuqta

paths faqat TypeScript'ga tekshirish uchun yo'lni aytadi. JavaScript kodidagi yo'lni u o'zgartirmaydi. Shuning uchun bundler'ga ham aytish kerak, aks holda TypeScript xato bermaydi, lekin ilova ishlaganda "module not found" chiqadi.

Vite'da:

// vite.config.ts
import { defineConfig } from "vite";
import path from "path";

export default defineConfig({
  resolve: {
    alias: {
      "@": path.resolve(__dirname, "./src"),
    },
  },
});

Yoki vite-tsconfig-paths plaginini o'rnatsangiz, u tsconfig'dagi paths'ni o'zi o'qiydi.

Next.js'da: qo'shimcha sozlash kerak emas, tsconfig'dagi paths avtomatik ishlaydi.

Eslab qoling

  • Ko'pchilik loyihalarda bitta @/* alias yetarli.
  • paths'ni ham tsconfig'da, ham bundler'da sozlang (Next.js bundan mustasno).
  • Bir papka ichidagi qo'shni fayllar uchun oddiy ./ yetarli, alias asosan uzoq papkalar uchun.