如何编译TypeScript？执行tsc命令无效该如何解决

1. 先确认本地typescript依赖安装正常 #

• 先清理异常安装缓存：删除项目下的node_modules文件夹，以及对应包管理器的锁文件（npm对应package-lock.json、yarn对应yarn.lock、pnpm对应pnpm-lock.yaml）
• 重新执行依赖安装命令：npm install，安装完成后检查node_modules/.bin目录下是否存在tsc可执行文件（Windows下是tsc.cmd，macOS/Linux下是无后缀的tsc文件）
• 如果目录下没有对应文件，单独重装TS本地开发依赖：npm install typescript --save-dev

2. 修正tsc命令的调用方式 #

没有全局安装typescript时，直接在终端输入裸tsc命令，系统只会从全局环境变量路径找程序，必然找不到，正确调用本地TS的方式有三种：

• 方式一：在package.json的scripts字段中添加编译脚本，示例：

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

  之后执行npm run build即可触发编译，npm会自动读取项目本地依赖里的tsc程序，不需要全局安装
• 方式二：用npx直接调用本地tsc，执行npx tsc即可，npx会优先匹配项目本地安装的TS版本
• 方式三：手动写全本地可执行文件路径调用：Windows系统执行node_modules\.bin\tsc.cmd，macOS/Linux系统执行./node_modules/.bin/tsc

3. 调用本地tsc仍编译失败的后续排查 #

• 先执行npx tsc --noEmit，只做类型检查不生成编译产物，根据终端输出的具体报错定位问题：如果是tsconfig.json相关报错，就检查配置文件是否存在、JSON格式是否合法、配置项是否和当前安装的TS版本匹配；如果是代码类型报错，就对应修复代码类型问题
• Windows系统如果提示脚本被禁止执行，先放开当前用户的脚本执行权限：执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，输入Y确认后重试即可
• 检查package.json里声明的typescript版本号是否为已发布的正式版本，不要填不存在的版本号，建议使用稳定版（如^5.4.0），避免版本不存在导致安装失败

不建议全局安装typescript，全局TS版本和项目本地依赖版本不一致时，很容易出现配置不兼容、编译结果和预期不符的问题，所有场景优先调用项目本地安装的TS版本。

内容的提问来源于stack exchange，提问作者rllynotfox