TypeScript路径导入报错：无法找到'app'包，求解决方案

问题根源 #

TypeScript的paths配置仅作用于编译阶段的类型检查和模块解析，编译后的JavaScript文件中依然保留app/*这类导入路径。而Node.js处理ES模块时，会将app视为npm包，去node_modules目录中查找，从而抛出ERR_MODULE_NOT_FOUND错误。

解决方案 #

方案1：编译时自动替换为相对路径（推荐生产环境） #

使用tsc-alias工具，在TypeScript编译完成后，自动将app/*路径替换为对应相对路径，让Node.js直接识别。

1. 安装开发依赖：

yarn add -D tsc-alias

2. 修改package.json中的start脚本，在tsc编译后执行路径替换：

"start": "rm -rf dist/ && yarn && yarn tsc && yarn tsc-alias && node --es-module-specifier-resolution=node dist/index.js"

3. 保留原tsconfig.json的paths配置即可，tsc-alias会自动读取该配置完成替换。

方案2：运行时通过工具映射路径（开发/生产通用） #

利用工具在Node.js运行时解析app/*路径，适配ES模块（type: module）环境：

方法A：使用module-alias

1. 在package.json中添加路径映射配置，与tsconfig的paths对应：

"_moduleAliases": {
  "app": "./dist/src"
}

（编译后src目录的文件会输出到dist下，所以映射到./dist/src）

2. 在项目入口文件（src/index.ts）顶部引入module-alias的注册模块：

import 'module-alias/register'

3. 修改start脚本，让Node加载module-alias：

"start": "rm -rf dist/ && yarn && yarn tsc && node --es-module-specifier-resolution=node -r module-alias/register dist/index.js"

方法B：使用tsconfig-paths

直接修改start脚本，通过ES模块加载器处理路径映射：

"start": "rm -rf dist/ && yarn && yarn tsc && node --es-module-specifier-resolution=node --loader tsconfig-paths/esm/register dist/index.js"

方案3：开发环境适配（配合tsx） #

用户当前用tsx做开发热重载，只需调整脚本路径并确保tsx读取tsconfig配置：

修改package.json中的serve:dev脚本：

"serve:dev": "tsx watch src/index.ts"

tsx会自动识别tsconfig.json中的paths配置，开发时可直接使用app/*导入。

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