TypeScriptを選ぶ理由

// JavaScript
function add(a, b) {
  return a + b;
}
add("hello", 42); // "hello42" -- 意図しない動作でもエラーにならない

// TypeScript
function add(a: number, b: number): number {
  return a + b;
}
add("hello", 42); // コンパイルエラー！ 型が合わないと教えてくれる

# Node.js のバージョン確認
node --version
# v20.x.x 以上を推奨

# npm のバージョン確認
npm --version

# プロジェクトディレクトリを作成
mkdir my-first-ts && cd my-first-ts

# package.json を初期化
npm init -y

# TypeScript をインストール
npm install -D typescript

# ts-node をインストール（TypeScriptを直接実行）
npm install -D ts-node @types/node

# tsconfig.json を生成
npx tsc --init

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "outDir": "./dist",
    "rootDir": "./src",
    "resolveJsonModule": true,
    "declaration": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

// src/index.ts
const message: string = "Hello, TypeScript!";
console.log(message);

// 型注釈付きの関数
function greet(name: string): string {
  return `こんにちは、${name}さん！`;
}

console.log(greet("田中"));
// console.log(greet(42)); // エラー！ number は string に代入できない

# ts-node で直接実行（開発時に便利）
npx ts-node src/index.ts

# コンパイルしてから実行（本番向け）
npx tsc
node dist/index.js

{
  "scripts": {
    "dev": "ts-node src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

# 開発時
npm run dev

# ビルド & 実行
npm run build && npm start

// const: 再代入不可（基本的にこれを使う）
const PI = 3.14159;
// PI = 3.14; // エラー！ const は再代入できない

// let: 再代入可能（ループカウンタなど）
let count = 0;
count = 1; // OK

// var: 使わない（スコープの問題があるため非推奨）
// var oldStyle = "avoid this";

// 原則: const を使う
const userName = "田中";
const maxRetries = 3;
const isActive = true;

// 値が変わる場合のみ let
let currentPage = 1;
currentPage = 2; // ページ遷移で更新

// for ループ
for (let i = 0; i < 10; i++) {
  console.log(i);
}

// 型推論: TypeScript が型を自動判定
const name = "太郎";        // string と推論される
const age = 25;             // number と推論される
const isStudent = false;    // boolean と推論される

// 明示的な型注釈（複雑な場合や関数の引数で使う）
const score: number = 100;
const greeting: string = `Hello, ${name}`;

// 良い例
function calculateTotal(price: number, quantity: number): number {
  return price * quantity;
}

// 変数は型推論に任せる
const total = calculateTotal(1500, 3); // number と推論される