[PR] 本記事にはプロモーションが含まれています。

【TypeScript】開発環境の基本:パッケージ管理から実行・serveコマンドまで

TypeScript

TypeScriptで開発を始める際、「ツールやコマンドが多すぎてどれを使えばいいか分からない」と悩む方は多いでしょう。

この記事では、TypeScript開発に必要なツール群を「パッケージ管理」「コンパイル・実行」「コード品質管理」の3つの役割に分類し、さらによく見かける npm run serve の役割についても体系的に解説します。

1. パッケージマネージャー(ライブラリの管理)

プロジェクトの土台となるツールです。どれか1つを選んで使います。現在新しく始める場合は npm または高速な pnpm が主流です。

ツール特徴代表的なコマンド
npmNode.jsに標準搭載されている最も基本的なツール。迷ったらこれを使用。npm init (初期化)
npm install <パッケージ> (追加)
npm run <スクリプト> (実行)
pnpmnpmより動作が高速で、ディスク容量の節約に優れた現代の主流。pnpm init, pnpm add, pnpm dev
yarn過去にnpmの遅さを解決するために普及したツール。yarn init, yarn add, yarn dev

2. コンパイラ・実行環境(TypeScriptを動かす)

TypeScriptはそのままではブラウザやNode.jsで動かないため、JavaScriptに変換(コンパイル)するか、直接実行できるツールを通す必要があります。

ツール役割よく使うコマンド
tscTypeScript公式コンパイラ。TSをJSに変換する。npx tsc --init (設定ファイル作成)
npx tsc (JSへ変換)
tsxTSファイルを変換せずに直接実行できるモダンなツール。開発中に便利。npx tsx index.ts
ts-nodetsxの古いバージョンにあたる定番ツール。最近はtsxへの移行が進む。npx ts-node index.ts
ViteReactなどのフロントエンド開発で使われる超高速ビルドツール。npm create vite@latest

3. コード品質管理(Lint・フォーマッタ)

コードの構文チェックや、見た目を整えるツールです。

ツール役割コマンド例
ESLintバグになりそうなコードやルール違反を検知する。npx eslint .
Prettierインデントや改行などのコードフォーマットを自動で整える。npx prettier --write .

4. 「npm run serve」の正体と役割

npm run serve は、npmにあらかじめ用意されている標準コマンドではなく、プロジェクトの package.json に独自に登録されたスクリプトを呼び出すためのコマンドです。
ブラウザで動作確認を行う環境を作る手順は以下の通りです。

サーバー用ツールのインストール:

開発用として serve を導入します。

Bash
npm install -D serve

package.jsonの編集:

scriptsの部分にビルドとサーバー起動のコマンドを登録します。

JSON
"scripts": {
  "build": "tsc",
  "serve": "serve -s ."
}

実行と確認:

以下のコマンドを実行し、表示されるローカルURLにアクセスします。

Bash
npm run build
npm run serve

5.最短環境構築の5ステップ

バックエンドやスクリプト実行用の最もシンプルなTypeScript環境を作る手順です。

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

空のディレクトリを作成し、パッケージマネージャーを初期化します。

Bash
npm init -y

2. TypeScriptパッケージのインストール

開発用の依存関係としてTypeScriptをインストールします。

Bash
npm install -D typescript

3. 設定ファイル(tsconfig.json)の生成

TypeScriptのコンパイル設定ファイルを生成します。

Bash
npx tsc --init

4. 実行用ツール(tsx)のインストール

開発中にファイルを直接実行できるように tsx を導入します。

Bash
npm install -D tsx

5. コードを書いて実行する

index.ts を作成してコードを書き、以下のコマンドで実行結果を確認します。

Bash
npx tsx index.ts

コメント