Windows全局安装TypeScript失败：缺失tsc.cmd文件

问题描述 #

使用Node.js v16.16.0（64位）在Windows执行npm install -g typescript后，C:\Users{MyUserName}\AppData\Roaming\npm\node_modules\typescript\bin目录下仅存在tsc文件，Windows系统依赖的tsc.cmd文件缺失，仅能在项目本地正常使用TypeScript。已确认环境变量包含C:\Users{MyUserName}\AppData\Roaming\npm和C:\Program Files\nodejs\node_modules，曾使用nvm后卸载，多次重装Node.js无效，其他机器同操作无异常，怀疑WSL干扰或权限/系统问题导致npm未生成.cmd文件。

解决步骤 #

1. 管理员权限下强制重装
   以管理员身份打开CMD或PowerShell，执行：

   npm install -g typescript --force
   

   管理员权限可规避系统权限限制，--force参数能覆盖异常缓存，强制重新生成相关文件。

2. 清理npm全局缓存后重装
   先清理缓存再重新安装：

   npm cache clean --force
   npm install -g typescript
   

3. 排查WSL干扰

   • 先关闭WSL服务：

     wsl --shutdown
     

     关闭后重新尝试全局安装，验证是否生成tsc.cmd。
   • 检查npm全局路径是否被WSL篡改：

     npm config get prefix
     

     确保返回Windows路径（如C:\Users{MyUserName}\AppData\Roaming\npm），若为Linux路径则重置：

     npm config set prefix "C:\Users{MyUserName}\AppData\Roaming\npm"
     

     替换{MyUserName}为你的实际用户名。

4. 手动创建tsc.cmd文件
   若上述方法无效，直接在C:\Users{MyUserName}\AppData\Roaming\npm目录下新建tsc.cmd文件，写入以下内容：

   @echo off
   node "%~dp0\node_modules\typescript\bin\tsc" %*
   

   保存后执行tsc -v确认是否生效。

5. 彻底清理Node.js残留后重装
   若之前卸载nvm/Node.js不彻底，可能残留配置影响：

   • 卸载Node.js后，删除以下目录：
     • C:\Program Files\nodejs
     • C:\Users{MyUserName}\AppData\Roaming\npm
     • C:\Users{MyUserName}\AppData\Roaming\npm-cache
     • C:\Users{MyUserName}\.nvm（若存在）
   • 清理系统环境变量中nvm/Node.js相关条目
   • 重启电脑后重新安装Node.js和全局TypeScript

内容的提问来源于stack exchange，提问作者Jamie Nicholl-Shelley