Bài 9. Mô-đun, tệp khai báo và cấu hình tsconfig

Khái niệm và lý thuyết

Mỗi tệp có import/export là một mô-đun với phạm vi riêng. Khi bạn import thư viện JS, TS cần biết kiểu của nó: thư viện hiện đại thường kèm sẵn .d.ts; thư viện cũ thì cài thêm @types/ten-thu-vien.

Từ 2025–2026, cách chạy TypeScript thay đổi nhiều: Node.js chạy trực tiếp tệp .ts bằng cơ chế xóa kiểu (type stripping); TypeScript 7 có trình biên dịch viết lại bằng Go, nhanh hơn khoảng 10 lần. Vai trò của tsc ngày càng tập trung vào kiểm tra kiểu (tsc --noEmit), còn việc chạy/đóng gói do Node.js, Vite, esbuild đảm nhận.

import và export

// toan.ts
export function tong(a: number, b: number) { return a + b; }
export type Diem = { x: number; y: number };
export default class MayTinh {}

// main.ts
import MayTinh, { tong } from "./toan.js";
import type { Diem } from "./toan.js"; // chỉ lấy kiểu

Với "module": "nodenext", đường dẫn import tương đối cần đuôi .js (hoặc .ts khi bật allowImportingTsExtensions).

Tệp khai báo

// globals.d.ts: khai báo biến toàn cục do script ngoài tạo ra
declare const APP_VERSION: string;

// Bổ sung kiểu cho mô-đun chưa có kiểu
declare module "thu-vien-cu" {
  export function lamGi(x: string): number;
}

npm install lodash
npm install -D @types/lodash

tsconfig.json khuyến nghị

{
  "compilerOptions": {
    "target": "es2022",
    "module": "nodenext",
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,
    "verbatimModuleSyntax": true,
    "skipLibCheck": true,
    "outDir": "dist"
  },
  "include": ["src"]
}

Các cách chạy TypeScript