Первый проект на TypeScript: как начать без боли (и не сломать себе психику)

🤔 Почему TypeScript вообще нужен?

Если коротко:
TypeScript — это JavaScript, который стал умнее.

Он помогает:

• ловить ошибки до запуска

• понимать код спустя неделю (и не плакать)

• не писать console.log("что тут вообще происходит") каждые 5 минут

👉 Если ты уже писал на JS — вход максимально лёгкий.

⚙️ Шаг 1. Установка — быстрее, чем открыть TikTok

npm init -y
npm install typescript --save-dev
npx tsc --init

💥 Всё. У тебя уже есть проект.

📁 Шаг 2. Первый файл

Создаём файл:

index.ts

Пишем код:

const message: string = "Привет, TypeScript!";
console.log(message);

Теперь компилируем:

npx tsc
node index.js

🎉 Ты только что запустил TypeScript. Без боли.

🧨 Шаг 3. Ловим кайф от типов

Попробуй это:

let age: number = 25;
age = "двадцать пять";

TypeScript такой:

❌ "Ты чё делаешь вообще?"

И не даст тебе запустить этот ужас.

🧠 Что происходит “под капотом” (коротко и по делу)

Когда ты запускаешь tsc, TypeScript:

• проверяет типы

• находит ошибки

• превращает твой код в обычный JavaScript

👉 Важно: браузер и Node.js не понимают TypeScript напрямую
Они видят уже скомпилированный JS.

Это значит:

• TypeScript — это не замена JS

• Это надстройка, которая делает тебя умнее при написании кода

🧩 База, которую нужно знать

Вот минимальный набор, чтобы не утонуть:

• string, number, boolean

• массивы: number[]

• объекты:

const user: { name: string; age: number } = {
  name: "Иван",
  age: 20,
};

• функции:

function sum(a: number, b: number): number {
  return a + b;
}

⚠️ Частая ошибка новичков

❌ Пытаться типизировать ВСЁ сразу
❌ Уходить в сложные generics
❌ Смотреть 5 часов теории вместо практики

✔️ Правильный путь:

написал → сломал → понял → пошёл дальше

🧠 Ещё один важный момент (который многие упускают)

TypeScript не делает твой код идеальным.

Он:

• не спасёт от плохой архитектуры

• не напишет код за тебя

• не заменит понимание логики

Но он:
👉 резко снижает количество тупых ошибок

Типа:

• передал строку вместо числа

• забыл поле в объекте

• неправильно вызвал функцию

И вот за это его реально любят в проде.

🔥 Мини-проект (чтобы закрепить)

Сделай простой CLI-калькулятор:

function calculate(a: number, b: number, op: string): number {
  if (op === "+") return a + b;
  if (op === "-") return a - b;
  return 0;
}

console.log(calculate(5, 3, "+"));

👉 Уже мини-проект. Уже опыт. Уже +1 к уверенности.

Если хочешь не просто читать, а прям реально прокачаться через практику, посмотри приложение Кодик.

Там:

• куча упражнений (не просто теория)

• обучение от простого к сложному

• система повторения (чтобы не забывать через день)

И ещё есть Telegram-сообщество, где:

• разбирают темы простым языком

• кидают полезные посты

• можно повторять материал, пока листаешь ленту

👉 Это как прокачка, только без скуки.

TypeScript — это не сложно.
Сложно — это пытаться писать большой проект без него.

Начни с малого:

• один файл

• один тип

• один запуск

И ты уже в игре.

А ты уже пробовал TypeScript или всё ещё живёшь на чистом JS?