TypeScript项目配置路径别名后运行编译JS提示找不到模块

你的问题核心在于：TypeScript的paths配置只是编译时的类型解析规则，TS编译后不会自动把代码里的别名替换成实际相对路径，所以Node运行时找不到对应的模块。因为要发布npm包，module-alias确实不合适，给你几个可行方案：

方案1：用tsc-alias替换编译后的路径（最省心） #

这个工具会在TS编译完成后，自动把输出文件里的别名替换成相对路径，最终生成的JS代码都是Node能识别的路径，完全不影响npm包的发布和使用。

1. 安装开发依赖：

npm install tsc-alias --save-dev

2. 修改package.json的build脚本，在tsc编译后执行tsc-alias：

"scripts": {
  "build": "tsc && tsc-alias"
}

3. 调整tsconfig.json里的paths配置（修正你当前的规则，确保匹配正确）：

"paths": {
  "*": ["node_modules/*", "src/types/*"],
  "@castorApp/*": ["src/castorApp/*"]
}

这样编译后，import { CastorApp } from "@castorApp/CastorApp"会被替换成对应层级的相对路径，Node运行就不会报错了。

方案2：用package.json的exports字段规范对外导入（推荐用于npm包） #

如果你的包希望用户也能通过类似别名的方式导入（比如import { CastorApp } from 'castor/castorApp'），可以结合方案1，再配置package.json的exports字段，既解决内部运行问题，又优化用户体验：

在package.json中添加：

"exports": {
  ".": "./bin/index.js",
  "./castorApp": "./bin/castorApp/CastorApp.js",
  "./castorApp/*": "./bin/castorApp/*"
}

这样用户安装你的包后，就能直接通过castor/castorApp导入对应模块，同时内部编译后的代码已经是相对路径，Node运行无问题。

方案3：改用相对路径导入（最稳妥但繁琐） #

如果不想额外加工具，直接放弃TS路径别名，改用相对路径编写导入语句：

import { CastorApp } from './castorApp/CastorApp';

这种方式编译后路径完全正确，Node能直接识别，适合小型项目或对依赖极简的场景。

额外注意 #

发布npm包前，记得检查：

• package.json的main字段指向正确的编译入口（你的配置是bin/index.js没问题）
• 确保bin目录下的所有文件都已正确编译，路径替换完成
• 可以本地测试：把包link到其他项目，验证导入是否正常

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