セットアップ

TypeScriptを使うには、typescript パッケージをインストールし、プロジェクトごとに tsconfig.json という設定ファイルを用意します。ここではまず最小構成のTypeScriptプロジェクトを準備し、続いて短いTypeScriptコードをコンパイル・実行して環境が正しく動いていることを確認します。

1. プロジェクトの初期化

まず、TypeScriptを扱うための空のプロジェクトを作り、typescript パッケージのインストールと tsconfig.json の生成までを行います。

任意の場所に ts-practice フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した ts-practice フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。

ts-practice  ← このフォルダを作成

以下のコマンドで、npm がインストールされていることを確認します。

npm --version

以下のように npm のバージョンが表示されれば、インストールは確認できています。

11.x.x

バージョンが表示されない場合は、Node.jsをインストールしよう を先に実施してください。

インストールが確認できたら、npm の初期化を行います。以下のコマンドを実行すると、package.json が生成されます。

npm init -y

次に、TypeScriptパッケージを開発用の依存関係としてインストールします。

npm install --save-dev typescript

インストールが完了したら、以下のコマンドで TypeScript がプロジェクトに正しく入っていることを確認します。

npx tsc --version

以下のように TypeScript のバージョンが表示されれば、インストールは確認できています。

Version 7.x.x
⚠️ 「Ok to proceed?」「This is not the tsc command」が出る場合
npx tsc --version を実行したときに Ok to proceed? や This is not the tsc command you are looking for のようなメッセージが表示される場合は、ローカルの TypeScript が見つかっていない状態です。npx が別の同名パッケージ(非公式の古い tsc)をダウンロードしようとしてしまうため、そのままでは次の手順も失敗します。ターミナルのカレントディレクトリが ts-practice フォルダになっているかを確認し、同じフォルダで npm install --save-dev typescript から実行し直してください。

バージョンが確認できたら、tsconfig.json を生成します。

npx tsc --init

以下のような実行結果が表示されます。

Created a new tsconfig.json with:
  target: es2016
  module: commonjs
  strict: true
  esModuleInterop: true
  skipLibCheck: true
  forceConsistentCasingInFileNames: true

tsconfig.json は、TypeScriptコンパイラ(tsc)に対する設定ファイルです。「どのバージョンのJavaScriptを出力するか」「どのファイルをコンパイル対象にするか」「型チェックをどこまで厳しくするか」といったコンパイル時の挙動を、プロジェクトごとに宣言します。TypeScriptのコマンドは、この tsconfig.json が置かれたフォルダをプロジェクトのルートとして扱います。

生成された tsconfig.json の中身は次のようになっています。ファイルには本来コメント付きで多数のオプションが並んでいますが、以下では既定で有効になっている項目だけを抜き出しています。

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

初学の段階で意識しておくべきなのは、次の3つのオプションです。

オプション 役割
target コンパイル後のJavaScriptがどのバージョンの構文で出力されるかを指定する
module 出力するモジュール形式を指定する(commonjs / esnext など)
strict 型チェックを厳しく行うかを切り替える(true を推奨)

strict: true を有効にすると、暗黙の any や null / undefined の混入を許さない厳格モードになります。個別に有効化できるフラグがまとめてONになる便利なスイッチで、TypeScriptの恩恵を最大限受けるために基本は true のままにします。

💡 ポイント
Next.jsのプロジェクトでは、npx create-next-app@latest を実行するだけで tsconfig.json が自動生成されます。ここで手動セットアップを体験しておくと、Next.jsが裏で何を用意しているかをイメージしやすくなります。

2. 動作確認

tsconfig.json まで用意できた状態で、TypeScriptのコードが実際にコンパイルされ、Node.jsで実行できることを確認します。ここでは hello.ts に短いコードを書き、コンパイルと実行を通してメッセージが表示されるまでを試します。

hello.ts を作成します。Visual Studio Codeのエクスプローラーで ts-practice フォルダを右クリックし、「新しいファイル」を選択して hello.ts という名前で作成してください。

ts-practice
├── node_modules/
├── package.json
├── package-lock.json
├── tsconfig.json
└── hello.ts  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

const message: string = "TypeScriptの世界へようこそ";
console.log(message);

以下のコマンドでコンパイルを実行します。

npx tsc hello.ts

同じフォルダに hello.js が生成されるので、node コマンドで実行します。

node hello.js

以下のような実行結果が表示されます。

TypeScriptの世界へようこそ

TypeScriptの世界へようこそ が出力されれば、hello.ts から生成された hello.js が Node.js で正しく実行され、TypeScriptプロジェクトの最小構成が動作していることが動作確認できます。

コードを解説します。

const message: string = "TypeScriptの世界へようこそ";

変数 message に対し : string と型注釈を書き、その型に沿った文字列を代入しています。この : 型名 の記法がTypeScriptの最小単位の型注釈で、以降の節で扱う型定義もこの延長線上にあります。

このように、TypeScriptのコードは tsc でJavaScriptにコンパイルしてから実行するのが基本的な流れになります。

💡 ポイント
ここでは動作確認のために tsc でJavaScriptに変換し、Node.jsで実行しました。実際のフロントエンド開発では、Vite・webpack・Next.jsといったバンドラが TypeScriptからJavaScriptへの変換とブラウザへの配信をまとめて自動で行います。次章で扱う Next.js では、create-next-app を実行するだけでこの仕組みが用意されるため、tsc を手動で叩く場面はほとんどなくなります。