Ошибка «tsc command not found» при компиляции TypeScript

Почему возникает ошибка и как её исправить

Ошибка tsc command not found означает, что система не может найти исполняемый файл tsc в переменной окружения PATH. Даже после глобальной установки TypeScript эта проблема часто возникает из-за особенностей конфигурации npm на разных операционных системах. Рассмотрим пошаговое решение.

Шаг 1: Проверьте глобальную установку

Убедитесь, что TypeScript действительно установлен глобально. Выполните команду:

npm list -g --depth=0

В выводе вы должны увидеть typescript. Если его нет — установите заново:

npm install -g typescript

Шаг 2: Найдите путь к tsc

После установки узнайте, куда npm поместил исполняемый файл:

npm root -g

Эта команда покажет путь к глобальной папке node_modules. Например, на Windows это может быть C:\Users\ИмяПользователя\AppData\Roaming\npm\node_modules. Исполняемый файл tsc должен находиться в папке .bin внутри этой директории. Полный путь будет выглядеть так: C:\Users\ИмяПользователя\AppData\Roaming\npm\node_modules\.bin\tsc.

Шаг 3: Добавьте путь в переменную PATH (Windows)

Если tsc там есть, но команда не работает — нужно добавить папку .bin в системную переменную PATH:

• Откройте «Панель управления» → «Система» → «Дополнительные параметры системы»
• Нажмите «Переменные среды»
• В разделе «Системные переменные» найдите Path и нажмите «Изменить»
• Добавьте новую строку: C:\Users\ИмяПользователя\AppData\Roaming\npm (обратите внимание — не .bin, а саму папку npm)
• Нажмите «ОК» во всех окнах и перезапустите терминал

Шаг 4: Альтернативный способ — используйте npx

Если не хотите возиться с путями, можно запускать компилятор через npx (он идёт в комплекте с npm):

npx tsc hello.ts

Это временное решение — npx сам находит установленный пакет. Для постоянной работы лучше настроить PATH.

Шаг 5: Проверка после исправления

После настройки PATH выполните:

tsc --version

Если видите версию (например, Version 5.3.3) — всё работает. Теперь скомпилируйте ваш файл:

tsc hello.ts

В результате появится файл hello.js с готовым JavaScript-кодом.

Дополнительная рекомендация

Начинающим разработчикам советую сразу настроить tsconfig.json для проекта:

tsc --init

Это создаст конфигурационный файл, и вы сможете запускать компиляцию простой командой tsc без указания имени файла.

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

npx tsc hello.ts

"scripts": {
    "build": "tsc"
}