NestJS项目Windows环境下TypeScript枚举导入模块找不到问题排查

• 路径大小写一致性检查
  Windows文件系统大小写不敏感，但TypeScript模块解析会严格匹配路径大小写。Mac/Linux下导入路径和实际文件路径大小写一致所以正常运行，Windows下系统虽能找到文件，但TS编译时会因大小写不匹配抛出模块找不到错误。
  操作：对比导入语句@shortcut/constants/enums/data-type.enum和实际文件、文件夹的大小写，比如constants是否实际为Constants，data-type.enum.ts是否实际为Data-Type.enum.ts，完全统一大小写后重新构建。

• 验证TS配置的路径映射
  打开tsconfig.json，检查paths和baseUrl配置：

  {
    "compilerOptions": {
      "baseUrl": "./src",
      "paths": {
        "@shortcut/*": ["shortcut/*"]
      }
    }
  }
  

  确认baseUrl指向正确的源码根目录，paths里的映射路径和实际文件夹结构完全匹配，注意路径用正斜杠（/），不要用Windows的反斜杠（\）。

• 同步webpack构建工具的别名配置
  NestJS默认用webpack构建，除了TS的paths，还要确保webpack配置里的resolve.alias和TS配置一致：

  const path = require('path');
  
  module.exports = {
    resolve: {
      alias: {
        '@shortcut': path.resolve(__dirname, 'src/shortcut/')
      }
    }
  };
  

  检查webpack配置（通常在webpack.config.js或nest-cli.json关联的配置文件）里的别名是否正确指向目标文件夹，避免路径拼接错误。

• 检查文件扩展名与模块解析配置
  若TS配置的moduleResolution为Node16/NodeNext，会对文件扩展名有更严格的要求。检查tsconfig.json的extensions配置：

  "compilerOptions": {
    "extensions": [".ts", ".js", ".json"]
  }
  

  确保.ts在扩展名列表中，同时确认实际文件的完整扩展名（比如是否是data-type.enum.ts而非被系统隐藏扩展名的data-type.enum）。

• 清理缓存后重新构建
  Windows下可能残留TS或webpack的缓存导致解析异常，执行以下操作：

  • 删除dist目录
  • 删除node_modules/.cache目录
  • 执行npm clean-install重新安装依赖
  • 重新运行构建命令

• 排查符号链接问题
  若项目中使用了符号链接，Windows下符号链接的权限或解析逻辑与Mac/Linux不同，可能导致模块找不到。尝试移除符号链接，改用实际文件路径，再测试构建是否正常。

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