全局安装自研TypeScript工具后报错：找不到rxjs/operators模块怎么办？

我开发了一款TypeScript工具并发布至Artifactory，执行npm install -g @org/my-tool@1.1.2可成功全局安装，但在终端运行my-tool -v时出现如下错误：

node:internal/modules/cjs/loader:1251
throw err;
^

Error: Cannot find module 'rxjs/operators'
Require stack:

该操作在Windows机器上可正常运行。我已尝试以下方案但均未解决：

• 使用不同Node.js版本重复操作
• 执行npm cache clean --force
• 重新安装Node.js
• 清理node_modules
• 重新构建工具包

针对性排查修复方案 #

1. 检查依赖声明正确性 #

• 确认rxjs在package.json的dependencies而非devDependencies中。全局安装不会自动安装devDependencies内的包，若误放会导致非Windows环境依赖缺失。
• 核对rxjs版本与代码中operators的兼容性，部分旧版本rxjs的operators导出路径存在差异。

2. 检查全局安装目录的依赖情况 #

• 执行npm root -g获取全局npm包安装路径，进入@org/my-tool目录查看rxjs是否存在：

  cd $(npm root -g)/@org/my-tool
  ls node_modules/rxjs
  

  若不存在，可尝试在该目录手动执行npm install rxjs测试临时修复效果。

3. 验证构建产物的模块解析路径 #

• 查看TypeScript编译后的产物（如dist目录），确认引入rxjs/operators的代码路径未被错误修改。
• 检查tsconfig.json的moduleResolution配置，建议设置为node16或nodenext以适配不同Node.js版本的模块解析规则。

4. 排查非Windows环境的npm权限与路径问题 #

• 尝试用sudo npm install -g @org/my-tool@1.1.2重新安装，避免权限不足导致依赖安装不完整。
• 执行echo $NODE_PATH查看环境变量，若NODE_PATH覆盖了默认模块查找路径，可临时取消该变量后重新测试。

5. 验证Artifactory上的包完整性 #

• 从Artifactory下载@org/my-tool@1.1.2的.tgz包，解压后检查package.json和内置node_modules（若有），确认rxjs存在且完整。
• 核对打包脚本（如npm pack）是否有排除node_modules的配置，导致依赖未被打包进发布包。

6. 测试本地全局安装本地构建包 #

• 在本地项目执行npm pack生成.tgz包，然后全局安装本地包测试：

  npm install -g ./my-tool-1.1.2.tgz
  

  若本地包运行正常，说明Artifactory上的包存在上传或打包异常；若仍报错，说明项目本身的打包或依赖配置有问题。

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