Настройка TypeScript-проекта и tsconfig.json

Создайте новую папку проекта и инициализируйте её:

mkdir ts-project
cd ts-project
npm init -y

Установите TypeScript как зависимость для разработки — не глобально, а именно в проект, чтобы версия компилятора была зафиксирована и одинакова у всей команды:

npm install typescript --save-dev

Шаг 1: Генерируем конфиг командой tsc --init

Вместо того чтобы писать конфиг с нуля, сгенерируйте его:

npx tsc --init

В консоли вы увидите примерно такое сообщение:

Created a new tsconfig.json with:
  target: es2016
  module: commonjs
  strict: true
  esModuleInterop: true
  skipLibCheck: true
  forceConsistentCasingInFileNames: true
 
You can learn more at https://aka.ms/tsconfig.json

Шаг 2: Смотрим, что внутри

Реальный файл получается длинным — большая часть строк там закомментирована и служит подсказками по каждой опции. Если убрать комментарии, активная часть выглядит так:

{
  "compilerOptions": {
    "target": "es2016",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

Обратите внимание на strict — этот флаг мы уже включали вручную в предыдущем уроке, а теперь он задан по умолчанию.

Все флаги, с которыми мы работали в предыдущих уроках, превращаются в обычные ключи объекта compilerOptions:

Шаг 3: Переносим исходники в src

Обновите tsconfig.json, добавив пути для исходников и результата компиляции:

{
  "compilerOptions": {
    "target": "es2020",
    "module": "commonjs",
    "strict": true,
    "rootDir": "src",
    "outDir": "dist",
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

Создайте папку src и файл src/index.ts:

function double(x: number): number {
  return x * 2;
}
 
console.log(double(21));

Шаг 4: Компилируем без единого флага

Теперь просто запустите:

npx tsc

Компилятор сам найдёт tsconfig.json, прочитает файлы из src и создаст результат в dist:

"use strict";
function double(x) {
    return x * 2;
}
console.log(double(21));

Никаких --target, --strict или --outDir в командной строке — всё уже прописано в конфиге один раз.

1. Добавьте в package.json скрипт "build": "tsc", чтобы команда запускала сборку через npm run build, а не вспоминала путь к tsc.
2. Добавьте туда же "typecheck": "tsc --noEmit" для проверки типов в CI без создания файлов.
3. Используйте npx tsc --showConfig, если конфиг наследуется из нескольких файлов и не очевидно, какие настройки применяются в итоге.

Сегодня мы перешли от разрозненных CLI-флагов к полноценной настройке проекта:

1. Установили typescript как dev-зависимость, а не глобально — версия компилятора теперь зафиксирована в проекте.
2. Сгенерировали tsconfig.json командой tsc --init вместо ручного написания конфига.
3. Перенесли уже знакомые флаги — target, strict, noEmit — в постоянные настройки конфига.
4. Разделили исходники и результат компиляции через rootDir и outDir.

В следующем уроке разберём tsconfig.json подробнее и посмотрим, какие ещё файлы — декларации типов, карты исходников — умеет создавать компилятор.