发布TypeScript包后依赖模块无法解析：未从node_modules查找

问题核心 #

发布的TypeScript包中，odata2ts.config.js被错误编译进dist目录，且其依赖的@odata2ts/odata2ts仅存在于包的devDependencies中，导致本地Angular项目构建时无法找到该模块。

具体原因 #

1. odata2ts.config.ts是构建阶段的工具配置文件，仅用于发布包内部的gen-odata脚本生成代码，不需要随包发布。但当前构建流程将其编译到了dist/esm目录，被包含在发布产物中。
2. @odata2ts/odata2ts被标记为开发依赖，安装发布包的本地项目不会自动安装该依赖，因此构建时出现模块未找到错误。

解决方案 #

1. 排除配置文件，禁止编译进dist #

修改发布包的所有TypeScript配置文件（config/tsconfig.cjs.json、config/tsconfig.esm.json、config/tsconfig.types.json），在exclude数组中添加配置文件路径：

{
  "exclude": [
    "node_modules",
    "odata2ts.config.ts",
    "src/resource", // 若xml资源仅用于构建，也可排除
    "src/build"
  ]
}

同时检查config/webpack.config.js，确保UMD打包流程也不会纳入该配置文件。

2. 调整依赖范围（仅当存在运行时依赖时用） #

如果发布包确实在运行时需要@odata2ts/odata2ts（当前场景不需要），将其从devDependencies移至dependencies：

// 发布包package.json
"dependencies": {
  "@odata2ts/http-client-fetch": "^0.6.2",
  "@odata2ts/odata-service": "^0.17.1",
  "@odata2ts/odata2ts": "^0.31.1"
}

3. 重新构建并发布包 #

清理旧产物后重新构建发布：

npm run clean
npm run build
npm publish

4. 本地项目更新依赖 #

在Angular项目中重新安装最新版本的包：

npm install @namespace/module@latest
npm run build

补充说明 #

发布包的files字段仅包含dist，只要确保dist目录中没有工具配置文件，就能避免此类问题。odata2ts属于开发阶段工具，无需让下游项目安装其依赖。

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