Предварительное требование: Установи Node.js (вместе с ним автоматически установится npm).
Выполни в терминале (командной строке) следующие шаги:
# 1. Создай папку проекта и зайди в неё
mkdir my-ts-app
cd my-ts-app
# 2. Инициализируй npm-проект (создаст package.json)
npm init -y
# 3. Установи TypeScript как инструмент разработки
npm install —save-dev typescript
# 4. Создай файл настроек компилятора
npx tsc —init
# 5. Создай папку для исходников и первый файл
mkdir src
echo ‘const message: string = «Привет из TypeScript!»;console.log(message);’ > src/index.ts
Теперь открой созданный tsconfig.json и найди (или добавь) две строчки. Они скажут компилятору, где брать код и куда его складывать:
«outDir»: «./dist»,
«rootDir»: «./src»,
Открой package.json и замени секцию «scripts» на:
«scripts»: {
«build»: «tsc»,
«start»: «node dist/index.js»,
«dev»: «npm run build && npm run start»
}
Собрать проект:
npm run build # Скомпилирует TS в JS
Запустить:
npm start # Запустит полученный JS-файл
Собрать проект и запустить сразу :
npm run dev
Из каких частей состоит базовый проект
Если представить проект как мини-фабрику. То её основные «цеха» и документы это :
📦 package.json — это Паспорт проекта. Хранит имя, версию, список подключённых библиотек и команды для запуска/сборки.
⚙️ tsconfig.json — это Инструкция для компилятора. Говорит TypeScript: «Файлы кода в src/, применяй строгие проверки, сохрани готовый JS в dist/».
📁 src/ — это папка «рабочая зона». Здесь код на TypeScript. Это единственная папка, где хранится основной кож.
📁 dist/ (или build/) — это папка Готовая продукция. Сюда компилятор автоматически кладёт преобразованный JavaScript. Именно его запускает Node.js.
📦 node_modules/ — это папка «Склад библиотек». Автоматически создаётся при комнде `npm install`. Внутри тысячи файлов. Не трогай и не меняй их вручную.
📄 .gitignore — это папка «Фильтр для Git». Информирует системе контроля версий: «Не сохраняй в репозиторий node_modules/ и dist/, их всегда можно восстановить».
📖 README.md — это файл «Заметок для людей». Краткое описание: что делает проект, как его запустить, какие технологии использует.
Как всё работает вместе:
Ты пишешь код с типами в src/index.ts или других файлах в папке src.
Команда `npm run build` запускает преобразование файлов TypeScript в исполняемый код JavaScript (папка `dist`). Согласно правилам описанным в tsconfig.json, так же происходит проверка код на ошибки.
Команда `npm start` запускает этот JS-файл через Node.js, и ты видишь вывод в консоли.