TypeScript ES模块中Import别名无法解析问题求助

问题分析 #

你遇到的报错核心原因是：ES模块环境下module-alias不兼容，且TypeScript的paths仅做编译时类型校验，编译后的代码仍保留别名语法，Node.js无法直接识别；同时你的package.json存在字段拼写错误，进一步影响了模块解析。

具体修复步骤 #

1. 修正package.json的拼写错误 #

将错误的"export"字段改为标准的"exports"：

{
  "name": "typetest",
  "version": "1.0.0",
  "exports": "./dist/main.js", // 修正字段拼写
  "type": "module",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node dist/main.js"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": "",
  "imports": {
    "#utils/*": "./dist/utils/*"
  }
}

2. 优化tsconfig.json配置 #

调整模块解析规则适配ES模块，补充必要配置项，确保编译时路径校验与运行时解析一致：

{
    "compilerOptions": {
      "module": "ESNext",
      "target": "ESNext",
      "moduleResolution": "bundler", // 改用bundler解析更适配ES模块场景
      "outDir": "./dist",
      "rootDir": "./src",
      "baseUrl": ".",
      "paths": {
        "#utils/*": ["src/utils/*"]
      },
      "esModuleInterop": true,
      "resolveJsonModule": true
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules", "dist"]
}

3. 用tsc-alias替换编译后的别名（可选兜底方案） #

如果上述配置后Node.js仍无法解析别名，可借助tsc-alias工具将编译后的别名直接替换为相对路径：

• 安装依赖：

npm install tsc-alias --save-dev

• 修改package.json的scripts：

{
  "scripts": {
    "build": "tsc && tsc-alias",
    "start": "npm run build && node dist/main.js"
  }
}

• 执行npm run start即可正常运行。

验证要点 #

• 确认src/utils目录下存在目标文件（比如math.ts），编译后dist/utils下有对应的输出文件；
• 检查代码中的导入语句格式正确，例如import { add } from '#utils/math'。

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