Windows环境下Git Bash运行tsc无法解析软链接文件问题

问题根源 #

Git Bash在非WSL环境下默认创建的是类Unix风格的软链接，而Windows原生的TypeScript编译器（tsc）依赖Windows文件系统API，没法正确识别这类软链接的路径；另外Git Bash的路径格式（比如/c/xxx）和Windows原生路径（C:\xxx）不兼容，也会导致tsc解析失败。

解决方案 #

• 改用Windows原生符号链接
  打开管理员权限的Command Prompt或PowerShell，用mklink命令创建兼容的符号链接：

  • 目录软链接：mklink /D "C:\你的项目路径\目标目录" "C:\实际文件路径\源目录"
  • 文件软链接：mklink "C:\你的项目路径\目标文件" "C:\实际文件路径\源文件"
    这种方式创建的链接能被tsc直接识别。

• 用tsconfig的paths映射替代软链接
  不需要依赖软链接，直接在tsconfig.json里配置路径映射，让tsc直接解析到实际文件：

  {
    "compilerOptions": {
      "baseUrl": "./",
      "paths": {
        "@shared/*": ["../shared-library/*"]
      }
    }
  }
  

  之后代码里用import { func } from '@shared/utils'就能直接引用到目标文件，完全绕开软链接问题。

• 让Git Bash创建Windows兼容的软链接
  以管理员权限运行Git Bash，创建软链接时加上-c参数强制生成Windows原生符号链接：
  ln -s -c "/c/实际文件路径/源目录" "/c/你的项目路径/目标目录"
  这样生成的软链接能被tsc正常解析。

• 在原生Windows终端运行tsc
  直接切换到Command Prompt或PowerShell里执行tsc命令，避免Git Bash的路径格式转换带来的解析问题，这是最直接的临时解决办法。

内容的提问来源于stack exchange，提问作者derpedy-doo