Monorepo场景下：如何发布含本地依赖的NPM包且不发布依赖包？

针对你遇到的只发布module1但依赖未发布的module2、且全局类型重复冲突的问题，给你几个可行的解决办法：

方案一：合并全局类型，移除对module2的依赖 #

• 直接将module2中的global.d.ts内容迁移到module1内部（比如放在src/types/global.d.ts）
• 修改module1的package.json，删除对module2的依赖声明
• 这种方式最直接，发布module1时完全不需要依赖未发布的module2，从根源上避免了类型重复冲突的问题

方案二：将module2作为内部依赖打包进module1 #

• 调整module1的打包配置（比如用Rollup、Webpack或TypeScript的路径映射）
• 在module1的tsconfig.json中配置paths，把module2指向本地路径：

  {
    "compilerOptions": {
      "paths": {
        "module2": ["../module2"]
      }
    }
  }
  

• 配置打包工具将module2的代码（包括类型）全部打包进module1的产物中，同时确保module1的package.json不再声明对module2的外部依赖
• 发布后module1是独立的包，不依赖任何未发布的模块

方案三：隔离全局类型，避免重复定义冲突 #

• 如果需要保留module2的独立结构，修改global.d.ts的声明方式，用命名空间隔离全局类型：

  declare global {
    namespace MyAppGlobalTypes {
      interface RequiredGlobalType {
        // 原全局类型内容
      }
    }
  }
  

• 在module1中通过MyAppGlobalTypes.RequiredGlobalType来引用类型，不再直接使用全局变量/类型
• 也可以在各模块的tsconfig.json中配置typeRoots，指定只加载自身模块的类型文件，避免重复加载外部全局类型

方案四：临时方案（不推荐正式使用） #

• 在module1的package.json中用file:依赖临时指向module2："module2": "file:../module2"
• 打包时确保将module2的内容包含进module1的产物，发布前务必移除这个file:依赖声明
• 这种方式容易在发布后出现依赖失效问题，仅适合本地测试场景

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