Node.js单目录多服务：Worker与API共享依赖管理方案咨询

这是个非常典型的Node.js多服务场景——既要让API和Worker物理隔离避免互相影响，又要复用公共代码和依赖减少冗余。我来给你梳理几个落地性强的解决方案：

这是目前业界处理这类问题的标准做法，能完美平衡代码复用、依赖管理和进程隔离的需求。

1. 基于npm/yarn/pnpm工作区（Workspaces）统一管理依赖 #

通过工作区配置，你可以在根目录集中安装公共依赖，同时让API和Worker作为独立子包保留各自的私有配置（比如eslint规则）：

• 调整目录结构：新增packages目录收纳所有子服务，再新增common子包存放共享代码：

  . 
  +-- .gitignore 
  +-- package.json  # 根目录配置文件，定义工作区规则
  +-- packages 
      +-- worker 
          +-- src/index.ts 
          +-- .eslintrc.js 
          +-- package.json  # 仅声明Worker特有的依赖
      +-- api 
          +-- src/index.ts 
          +-- .eslintrc.js 
          +-- package.json  # 仅声明API特有的依赖
      +-- common 
          +-- src/  # 存放公共函数、TypeScript类型、工具类等
          +-- package.json 
  

• 配置根目录工作区：在根目录的package.json中添加工作区规则：

  {
    "name": "my-service-monorepo",
    "private": true,
    "workspaces": [
      "packages/*"
    ]
  }
  

  执行npm install时，公共依赖会被安装在根目录的node_modules，子包的私有依赖会自动存放在各自目录（根目录没有的情况下），彻底避免重复安装。
• 关联公共代码包：在API和Worker的package.json中，添加对common包的依赖：

  {
    "dependencies": {
      "@my-monorepo/common": "1.0.0"
    }
  }
  

  这里的包名要和common子包的package.json中定义的name保持一致。

2. 公共代码的复用方式 #

把API和Worker共享的逻辑全部迁移到packages/common/src下，比如：

• packages/common/src/utils/request-validator.ts：公共请求校验函数
• packages/common/src/types/shared.d.ts：共享的TypeScript类型定义
  然后在API或Worker中直接导入使用：

import { validateWorkerTask } from '@my-monorepo/common/src/utils/request-validator';

3. 确保进程隔离，避免Worker负载溢出 #

Monorepo完全不影响API和Worker的独立运行：

• 在每个子包的package.json中定义启动脚本：
  比如Worker的package.json：

  {
    "scripts": {
      "start": "ts-node src/index.ts"
    }
  }
  

• 可以单独启动每个服务，也可以在根目录统一管理：
  根目录package.json添加脚本：

  {
    "scripts": {
      "start:api": "npm start --workspace=packages/api",
      "start:worker": "npm start --workspace=packages/worker",
      "start:all": "npm run start:api & npm run start:worker"
    }
  }
  

  这样两个服务是完全独立的进程，API的请求不会直接转嫁到Worker，你还能单独监控、扩容每个服务。

如果暂时不想重构Monorepo，可以用符号链接临时共享代码和依赖：

• 公共代码：在根目录新建common文件夹，然后在API和Worker的src目录下执行ln -s ../../common ./common（Windows需管理员权限），实现代码共享。
• 依赖：删除API和Worker各自的node_modules，在根目录安装所有依赖后，在子包目录执行ln -s ../../node_modules ./node_modules。
  但这个方案跨平台兼容性差，依赖管理容易混乱，仅适合临时过渡。

• TypeScript配置：在根目录放一个tsconfig.base.json，让子包继承基础配置，减少重复代码。
• 依赖管理工具：推荐用pnpm替代npm/yarn，它的工作区依赖更高效，磁盘占用更少。
• 部署：每个子包单独编译打包（比如用tsc），然后分别部署API和Worker，确保生产环境完全隔离。

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