もくじ
tscコマンドを実行すると以下のようなエラーが表示されることがあります。
'tsc' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチファイルとして認識されていません。
このエラーが表示される場合、npmのパス設定や環境変数に原因があることが多いです。
本記事では、tscが動かない原因とその解決策を初心者でも分かりやすく解説します。
- Windows
- Node.js 22.14.0
- TypeScript 5.8.2
tscコマンドが実行できない原因
- TypeScriptがインストールされていない
- npmのグローバルパスが環境変数に設定されていない
では、それぞれの解決策を見ていきましょう。
①TypeScriptがインストールされていない場合の対応方法
「コマンド プロンプト」にnpm prefix -gと入力し、npmのグローバルパッケージがインストールされているディレクトリパスを確認します。
npm prefix -g
表示されたディレクトリに移動し、tsc.cmdが存在するか確認します。
存在しない場合はTypeScriptがインストールされていない可能性があるため、TypeScriptをインストールします。
tsc.cmdが存在する場合は、npmのグローバルパスが環境変数に設定されていない場合の対応方法の内容を確認してください。
TypeScriptのインストール方法は以下記事で解説しています。
-
【Windows】TypeScriptのインストール手順
もくじ事前準備（Node.jsのインストール）TypeScriptのインストール手順TypeScriptのインストール確認 Windows PCでTypeScriptをインストールする手順とTypeS ...
②npmのグローバルパスが環境変数に設定されていない場合の対応方法
「コマンド プロンプト」にnpm prefix -gと入力し、npmのグローバルパッケージがインストールされているディレクトリパスを取得します。
このパスが環境変数に設定されていないと、tscをコマンドとして認識できないため、環境変数PATHにnpmのグローバルパスを追加する必要があります。
npm prefix -g
環境変数PATHにnpmのグローバルパスを追加する手順
「Win + R」を押して「ファイル名を指定して実行」を開く
「名前(O)」に
sysdm.cplと入力し、「OK」をクリック
「詳細設定」タブをクリック
「環境変数(N)...」をクリック
「ユーザー環境変数(U)」の「Path」を選択し、「編集(E)...」をクリック
「新規(N)」をクリック
npm prefix -gで取得したパスを追加（例: C:\Users\ユーザー名\AppData\Roaming\npm）
「OK」をクリックして設定を保存する
「OK」をクリック
コマンドプロンプトを再起動
「コマンド プロンプト」に
tsc -vなどのtscコマンドを入力し、「Enter」を押下
正常に動作するか確認する
udemyでTypeScriptを学ぶ
- TypeScriptの基礎的な型からコンパイラの設定方法、クラスやインターフェース、応用的な型まで
- ジェネリクスや、デコレータ、モジュール、Webpack、JavaScriptライブラリーの使い方など実践的な開発方法
- オブジェクト指向プログラミングを使ったデモの健康管理アプリの開発
- React/ViteやNode jsとTypeScriptを一緒に使う方法
- TypeScriptに挑戦したいJavaScriptエンジニア
- もっとTypeScriptについて詳しく知りたいAngularエンジニア
- ReactやVueの様なJavaScriptフレームワークを使っていて、TypeScriptにも興味を持っているフロントエンドエンジニア
- モダンな開発に興味がある方
- Progateを一通り終えて、新しい言語を学びたい方
- 本で学ぶよりも動画で学ぶ方が好きな方
もみじ
動画で TypeScript について学びたい方におすすめの講座です。
私も TypeScript の概要を学びたいと思い、この講座を受講しましたが、丁寧な解説で分かりやすかったです。
プログラミング未経験の初学者にとっては、一度で理解するのは難しいかもしれません。